--- title: "Get Endpoints" slug: "get-endpoints-2" tags: ["IPS 11.1.x", "Reference"] updated: 2026-11-19T12:57:44Z published: 2026-11-19T12:57:44Z canonical: "docs.trellix.com/get-endpoints-2" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Endpoints This URL gets the endpoints information. ### Resource URL GET //endpointintelligence//endpoints? duration= ### Request Parameters | Field Name | Description | Data Type | Mandatory | | --- | --- | --- | --- | | `duration` | Duration - LAST_5_MINUTES - LAST_1_HOUR - LAST_6_HOURS - LAST-12_HOURS - LAST_24_HOURS - LAST_48_HOURS - LAST_7_DAYS - LAST_14_DAYS | String | No | | `hash` | Hash | String | Yes | | `nbaId` | NTBA monitors id | String | Yes | ### Response Parameters Following fields are returned if the request parameters are correct, otherwise error details are returned. | Field Name | Description | Data Type | | --- | --- | --- | | `EndpointList` | List of endpoints | Array | Details of EndpointList: | Field Name | Description | Data Type | | --- | --- | --- | | `ipAddress` | Executable hash | String | | `hostName` | Executable name | String | | `os` | Executable versions | String | | `user` | Classification | String | | `connectionsCount` | Connections count | Int | | `eventsCount` | Events count | Int | ### Example **Request** GET [https:///sdkapi/1001/endpointintelligence/aaaaaaaa16/endpoints?duration=LAST_14_DAYS](https://<NSM_IP>/sdkapi/1001/endpointintelligence/aaaaaaaa16/endpoints?duration=LAST_14_DAYS) **Response** ``` { "endpointList": [{"ipAddress":"2.1.1.1","hostName":"","os":"","user":"poori.com\\admin@test.com","connectionsCount":3,"eventsCount":0}] } ``` ### Error Information Following error codes are returned by this URL: | S.No | HTTP Error Code | SDK API errorId | SDK API errorMessage | | --- | --- | --- | --- | | 1 | 400 | 3601 | Invalid duration | | 2 | 400 | 4901 | Invalid hash/failed retrieve |