> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/api-en/back-office-api-reference/system-bo-api/user-access-history-lookup.md).

# User Access History Lookup

## Retrieve User Access History List

> \## Function Description\
> \* Retrieves the user access history list matching the system type, user ID/name, search period, and login reason presence.\
> \---\
> \## Detailed Description\
> \* Retrieves the user access history list matching the system type, user ID/name, search period, and login reason presence.\
> \---\
> \## Revision History\
> \* Release v2.00\_240530: Changed date search query<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"LoginLogRequest":{"type":"object","properties":{"userId":{"type":"string"},"sysGbCd":{"type":"string"},"userIdConditionParam":{"type":"string"},"userNmConditionParam":{"type":"string"},"loginDtmStart":{"type":"string","format":"date"},"loginDtmEnd":{"type":"string","format":"date"},"connCausCont":{"type":"string"},"excelHeader":{"type":"string"}}},"ResponseRealGridListResponseLoginLogResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/RealGridListResponseLoginLogResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseLoginLogResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/LoginLogResponse"}}}},"LoginLogResponse":{"type":"object","description":"User Access History Response DTO","properties":{"sysGbCd":{"type":"string","description":"System Classification Code"},"sysGbNm":{"type":"string","description":"System Classification Name"},"userId":{"type":"string","description":"User ID"},"userNm":{"type":"string","description":"User Name"},"loginDtm":{"type":"string","format":"date-time","description":"Login Date/Time"},"loginIpAddr":{"type":"string","description":"Login IP Address"},"connCausCont":{"type":"string","description":"Access Reason"},"loutDtm":{"type":"string","format":"date-time","description":"Logout Date/Time"},"pwdLockYn":{"type":"string","description":"Locked Status"},"loginCnt":{"type":"integer","format":"int32","description":"Login Count"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/system/userAccessHistoryInquiry/getLastLoginInfoList":{"get":{"tags":["User Access History Lookup"],"summary":"Retrieve User Access History List","description":"## Function Description\n* Retrieves the user access history list matching the system type, user ID/name, search period, and login reason presence.\n---\n## Detailed Description\n* Retrieves the user access history list matching the system type, user ID/name, search period, and login reason presence.\n---\n## Revision History\n* Release v2.00_240530: Changed date search query\n","operationId":"getLastLoginInfoList","parameters":[{"name":"stlogLoginLogRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/LoginLogRequest"}},{"name":"sysGbCd","in":"query","description":"System Classification Code","schema":{"type":"string"}},{"name":"userIdConditionParam","in":"query","description":"User ID Search Name","schema":{"type":"string"}},{"name":"userNmConditionParam","in":"query","description":"User Name Search Name","schema":{"type":"string"}},{"name":"loginDtmStart","in":"query","description":"Search Start Date","schema":{"type":"LocalDate"}},{"name":"loginDtmEnd","in":"query","description":"Search End Date","schema":{"type":"LocalDate"}},{"name":"connCausCont","in":"query","description":"Search Reason Presence","schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"Current Page","required":true,"schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"Rows per Page","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseLoginLogResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Retrieve User Access History Detail List

> \## Function Description\
> \* Retrieves the user access history detail list matching the system type, user ID, search period, and login reason presence.\
> \---\
> \## Detailed Description\
> \* Retrieves the user access history detail list matching the system type, user ID, search period, and login reason presence.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"LoginLogRequest":{"type":"object","properties":{"userId":{"type":"string"},"sysGbCd":{"type":"string"},"userIdConditionParam":{"type":"string"},"userNmConditionParam":{"type":"string"},"loginDtmStart":{"type":"string","format":"date"},"loginDtmEnd":{"type":"string","format":"date"},"connCausCont":{"type":"string"},"excelHeader":{"type":"string"}}},"ResponseRealGridListResponseLoginLogResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/RealGridListResponseLoginLogResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseLoginLogResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/LoginLogResponse"}}}},"LoginLogResponse":{"type":"object","description":"User Access History Response DTO","properties":{"sysGbCd":{"type":"string","description":"System Classification Code"},"sysGbNm":{"type":"string","description":"System Classification Name"},"userId":{"type":"string","description":"User ID"},"userNm":{"type":"string","description":"User Name"},"loginDtm":{"type":"string","format":"date-time","description":"Login Date/Time"},"loginIpAddr":{"type":"string","description":"Login IP Address"},"connCausCont":{"type":"string","description":"Access Reason"},"loutDtm":{"type":"string","format":"date-time","description":"Logout Date/Time"},"pwdLockYn":{"type":"string","description":"Locked Status"},"loginCnt":{"type":"integer","format":"int32","description":"Login Count"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/system/userAccessHistoryInquiry/getDetailLoginHistoryList":{"get":{"tags":["User Access History Lookup"],"summary":"Retrieve User Access History Detail List","description":"## Function Description\n* Retrieves the user access history detail list matching the system type, user ID, search period, and login reason presence.\n---\n## Detailed Description\n* Retrieves the user access history detail list matching the system type, user ID, search period, and login reason presence.\n","operationId":"getDetailLoginHistoryList","parameters":[{"name":"stlogLoginLogRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/LoginLogRequest"}},{"name":"userId","in":"query","description":"User ID","schema":{"type":"string"}},{"name":"sysGbCd","in":"query","description":"System Classification Code","schema":{"type":"string"}},{"name":"loginDtmStart","in":"query","description":"Search Start Date","schema":{"type":"string"}},{"name":"loginDtmEnd","in":"query","description":"Search End Date","schema":{"type":"string"}},{"name":"connCausCont","in":"query","description":"Search Reason Presence","schema":{"type":"string"}},{"name":"pageIdx","in":"query","description":"Current Page","required":true,"schema":{"type":"string"}},{"name":"rowsPerPage","in":"query","description":"Rows per Page","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseLoginLogResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```