---
title: "Get Scanner Agents"
method: GET
path: "/api/scanner/agents/"
tags: ["Scanner"]
---

# Get Scanner Agents

`GET /api/scanner/agents/`

Retrieve the list of scanner agents available for initiating private scans from different geolocations.

## Response `200`

__Scanner Agents__

- ScannerAgent[]
  - `id` integer, required — Identifier of the scanner agent to use for the scan.
  - `description` string — Human-readable description of the scanner agent.
  - `name` string, required — Agent name.
  - `label` string, required — Agent label.
  - `location` string, required — Agent geolocation as an ISO 3166-1 alpha-2 country code.
  - `ip_address` Ipv4[], required — Public IP addresses used by the scanner agent.
  - `is_default` boolean — Indicates whether this agent is the default scanner agent for the user.
  - `queue_eta` integer — Estimated queue waiting time for this agent, in seconds.

## Other responses

- `401` — __Unauthorized__: The request was rejected due to missing or invalid authentication credentials
- `500` — __Internal Server Error__: Details are included in the response body

---

[API](https://skmtc.net/netlas/apis/netlas-api.md) · [All operations](https://skmtc.net/netlas/apis/netlas-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netlas/netlas-api/revisions/2b1f84425791/schema)