--- title: "Get Endpoints" slug: "get-endpoints" tags: ["Reference", "IPS 10.1.10"] updated: 2026-09-23T09:38:00Z published: 2026-09-23T09:38:00Z canonical: "docs.trellix.com/get-endpoints" --- > ## 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://%3CNSM_IP%3E/sdkapi/1001/endpointintelligence/aaaaaaaa16/endpoints?duration=LAST_14_DAYS](https://%3CNSM_IP%3E/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 |