> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Endpoints

Retrieves detailed information about your endpoints.

Required API key role permissions:

* `Endpoint Inventory - view`

<Note>
  External Documentation

  To learn more, visit the [Trend Vision One documentation](https://automation.trendmicro.com/xdr/api-v3/#tag/Search/paths/~1v3.0~1eiqs~1endpoints/get).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                                                                                                                                                                                                       |
  | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Filter           | Filter for retrieving a subset of the collected endpoint information data.<br /><br />For example: `not (osName eq 'Windows')`.<br /><br />For further information, please refer to [Trend Vision One Documentation](https://automation.trendmicro.com/xdr/api-v3/#tag/Search/paths/~1v3.0~1eiqs~1endpoints/get). |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                                                                                                                                                                                                                  |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter  | Description                                                                                                                                          |
  | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Limit      | The number of results per page.                                                                                                                      |
  | Skip Token | The pagination token that's used for retrieving the next page of results.<br />It is returned in `nextLink`, as a query parameter named `skipToken`. |
</div>

## Example Output

```json theme={"dark"}
{
	"items": [
		{
			"agentGuid": "35fa11da-a24e-40cf-8b56-baf8828cc151",
			"loginAccount": {
				"value": [
					"MSEDGEWIN10\\\\IEUser"
				],
				"updatedDateTime": "2020-06-01T02:12:56Z"
			},
			"endpointName": {
				"value": "MSEDGEWIN10",
				"updatedDateTime": "2020-06-01T02:12:56Z"
			},
			"macAddress": {
				"value": [
					"00:1c:42:be:22:5f"
				],
				"updatedDateTime": "2020-06-01T02:12:56Z"
			},
			"ip": {
				"value": [
					"10.211.55.36"
				],
				"updatedDateTime": "2020-06-01T02:12:56Z"
			},
			"osName": "Linux",
			"osVersion": "10.0.17763",
			"osDescription": "Windows 10 Enterprise Evaluation (64 bit) build 17763",
			"productCode": "sao",
			"installedProductCodes": [
				"xes"
			],
			"componentUpdatePolicy": "N-2",
			"componentUpdateStatus": "pause",
			"componentVersion": "outdatedVersion",
			"policyName": "Example Policy Name",
			"protectionManager": "A1-US"
		}
	],
	"nextLink": "https://api.xdr.trendmicro.com/v3.0/eiqs/endpoints?skipToken=skipToken"
}
```

## Workflow Library Example

[List Endpoints with Trend Vision One and Send Results Via Email](https://library.blinkops.com/workflows/list-endpoints-with-trend-vision-one-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-endpoints-with-trend-vision-one-and-send-results-via-email/canvas" />
</div>