> ## 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 Agents

List and query all agents.

<Note>
  External Documentation

  To learn more, visit the [Acronis documentation](https://developer.acronis.com/doc/agents/v2/reference/index.html#docs/method/#/web-api/endpoint/%2Fagents/supportedOperation/get).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter | Description                                                                                                                                                                                                                                                                                    |
  | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Hostname  | The hostname of the agnet to query by.<br />You can use the following function in your query:<br /><br />\* **hlike** - hostname starts with specified string.<br />\* **like** - hostname contains specified string in any position.<br />\* **tlike** - hostname ends with specified string. |
  | Online    | Query by the online status of the agent.                                                                                                                                                                                                                                                       |
  | Os Family | Query by the os family of the agent.                                                                                                                                                                                                                                                           |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter  | Description                                                   |
  | ---------- | ------------------------------------------------------------- |
  | After      | A next page cursor that is returned in a previous return.     |
  | Before     | A previous page cursor that is returned in a previous return. |
  | Limit      | The amount of results to return per page.                     |
  | Order      | The order that the results are returned in.                   |
  | Tenant ID  | Query by the tenant ID of the agent.                          |
  | Unit       | Query by the name of registered agent unit.                   |
  | Up To Date | Query by the up to date status of the agent.                  |
</div>

## Example Output

```json theme={"dark"}
{
	"items": [
		{
			"id": "8f27a66f-71ff-4b5c-b665-75ec0f42b849",
			"core_version": {
				"current": {
					"release_id": "1.0.0",
					"build": "42"
				}
			},
			"units": [
				{
					"name": "atp",
					"version": {
						"current": {
							"release_id": "1.0.0",
							"build": "42"
						},
						"latest": {
							"release_id": "1.0.1",
							"build": "57"
						}
					}
				},
				{
					"name": "backup",
					"version": {
						"current": {
							"release_id": "1.0.0",
							"build": "42"
						}
					}
				}
			],
			"auto_update": true,
			"meta": {},
			"hostname": "server1.acme.local",
			"platform": {
				"family": "WINDOWS",
				"arch": "X64",
				"name": "Windows 2019",
				"version_major": 10,
				"version_minor": 0
			},
			"tenant": {
				"id": "64",
				"name": "ACME"
			},
			"name": "My Appliance 6490-78",
			"online": true,
			"enabled": true,
			"registration_date": "Tue, 04 Jun 2019 18:32:26 +0300",
			"registration_id": "eO2uM8QwSIC3nh0FxiZmjArpW-U",
			"installer_version": {
				"current": {
					"major": 15,
					"minor": 0,
					"build_number": 27714
				}
			},
			"timezone": "+0300"
		}
	],
	"paging": {
		"cursors": {
			"after": "aGVhbHRoY2hlY2s6C",
			"before": "CiAgdGltZW91dDogMTBzCi"
		}
	}
}
```

## Workflow Library Example

[List Agents with Acronis and Send Results Via Email](https://library.blinkops.com/workflows/list-agents-with-acronis-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-agents-with-acronis-and-send-results-via-email/canvas" />
</div>