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

# Get Agents

Returns the details for all agents.

<Note>
  External Documentation

  To learn more, visit the [Rapid7 documentation](https://help.rapid7.com/insightvm/en-us/api/index.html#operation/getAgents).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter               | Description                                                                                                                                                                                                               |
  | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Disable SSL Enforcement | Enable this option to skip SSL verification of the server's certificate<br />chain and host name. This may increase security vulnerabilities, but can be useful<br />for testing or when custom verification is employed. |
  | Page                    | The index of the page (zero-based) to retrieve.                                                                                                                                                                           |
  | Return All Pages        | Automatically fetch all resources, page by page.                                                                                                                                                                          |
  | Size                    | The number of records per page to retrieve.                                                                                                                                                                               |
  | Sort                    | The criteria to sort the records by, in the format: property\[,ASC\|DESC]. The default sort order is ascending.<br />Multiple sort criteria can be specified using multiple sort query parameters.                        |
</div>

## Example Output

```json theme={"dark"}
{
	"links": [
		{
			"href": "https://hostname:3780/api/3/...",
			"rel": "self"
		}
	],
	"page": {
		"number": 6,
		"size": 10,
		"totalPages": 13,
		"totalResources": 123
	},
	"resources": [
		{
			"addresses": [
				{
					"ip": "123.245.34.235",
					"mac": "12:34:56:78:90:AB"
				}
			],
			"agentId": "fe1708451f8c78c3a20a8a79818878e1",
			"assessedForPolicies": false,
			"assessedForVulnerabilities": true,
			"configurations": [
				{
					"name": "<name>",
					"value": "<value>"
				}
			],
			"databases": [
				{
					"description": "Microsoft SQL Server",
					"id": 13,
					"name": "MSSQL"
				}
			],
			"files": [
				{
					"attributes": [
						{
							"name": "<name>",
							"value": "<value>"
						}
					],
					"name": "ADMIN$",
					"size": 1,
					"type": "directory"
				}
			],
			"history": [
				{
					"date": "2018-04-09T06:23:49Z",
					"description": "",
					"scanId": 12,
					"type": "SCAN",
					"user": "",
					"version": 8,
					"vulnerabilityExceptionId": ""
				}
			],
			"hostName": "corporate-workstation-1102DC.acme.com",
			"hostNames": [
				{
					"name": "corporate-workstation-1102DC.acme.com",
					"source": "DNS"
				}
			],
			"id": 282,
			"ids": [
				{
					"id": "c56b2c59-4e9b-4b89-85e2-13f8146eb071",
					"source": "WQL"
				}
			],
			"ip": "182.34.74.202",
			"lastAssessedForVulnerabilities": "2019-09-11T10:39:51.288Z",
			"links": [
				{
					"href": "https://hostname:3780/api/3/...",
					"rel": "self"
				}
			],
			"mac": "AB:12:CD:34:EF:56",
			"os": "Microsoft Windows Server 2008 Enterprise Edition SP1",
			"osCertainty": "0.75",
			"osFingerprint": {
				"architecture": "x86",
				"configurations": [
					{
						"name": "<name>",
						"value": "<value>"
					}
				],
				"cpe": {
					"edition": "enterprise",
					"language": "",
					"other": "",
					"part": "o",
					"product": "windows_server_2008",
					"swEdition": "",
					"targetHW": "",
					"targetSW": "",
					"update": "sp1",
					"v2.2": "cpe:/o:microsoft:windows_server_2008:-:sp1:enterprise",
					"v2.3": "cpe:2.3:o:microsoft:windows_server_2008:-:sp1:enterprise:*:*:*:*:*",
					"vendor": "microsoft",
					"version": "-"
				},
				"description": "Microsoft Windows Server 2008 Enterprise Edition SP1",
				"family": "Windows",
				"id": 35,
				"product": "Windows Server 2008 Enterprise Edition",
				"systemName": "Microsoft Windows",
				"type": "Workstation",
				"vendor": "Microsoft",
				"version": "SP1"
			},
			"rawRiskScore": 31214.3,
			"riskScore": 37457.16,
			"services": [
				{
					"configurations": [
						{
							"name": "<name>",
							"value": "<value>"
						}
					],
					"databases": [
						{
							"description": "Microsoft SQL Server",
							"id": 13,
							"name": "MSSQL"
						}
					],
					"family": "",
					"links": [
						{
							"href": "https://hostname:3780/api/3/...",
							"rel": "self"
						}
					],
					"name": "CIFS Name Service",
					"port": 139,
					"product": "Samba",
					"protocol": "tcp",
					"userGroups": [
						{
							"id": 972,
							"name": "Administrators"
						}
					],
					"users": [
						{
							"fullName": "Smith, John",
							"id": 8952,
							"name": "john_smith"
						}
					],
					"vendor": "",
					"version": "3.5.11",
					"webApplications": [
						{
							"id": 30712,
							"pages": [
								{
									"linkType": "html-ref",
									"path": "/docs/config/index.html",
									"response": 200
								}
							],
							"root": "/",
							"virtualHost": "102.89.22.253"
						}
					]
				}
			],
			"software": [
				{
					"configurations": [
						{
							"name": "<name>",
							"value": "<value>"
						}
					],
					"cpe": {
						"edition": "enterprise",
						"language": "",
						"other": "",
						"part": "o",
						"product": "windows_server_2008",
						"swEdition": "",
						"targetHW": "",
						"targetSW": "",
						"update": "sp1",
						"v2.2": "cpe:/o:microsoft:windows_server_2008:-:sp1:enterprise",
						"v2.3": "cpe:2.3:o:microsoft:windows_server_2008:-:sp1:enterprise:*:*:*:*:*",
						"vendor": "microsoft",
						"version": "-"
					},
					"description": "Microsoft Outlook 2013 15.0.4867.1000",
					"family": "Office 2013",
					"id": 0,
					"product": "Outlook 2013",
					"type": "Productivity",
					"vendor": "Microsoft",
					"version": "15.0.4867.1000"
				}
			],
			"type": "",
			"userGroups": [
				{
					"id": 972,
					"name": "Administrators"
				}
			],
			"users": [
				{
					"fullName": "Smith, John",
					"id": 8952,
					"name": "john_smith"
				}
			],
			"vulnerabilities": {
				"critical": 16,
				"exploits": 4,
				"malwareKits": 0,
				"moderate": 3,
				"severe": 76,
				"total": 95
			}
		}
	]
}
```

## Workflow Library Example

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