---
title: "List Scanning Agents"
method: GET
path: "/scanning-agents/"
tags: ["Scanning Agents"]
---

# List Scanning Agents

`GET /scanning-agents/`

## Query parameters

- `length` integer
- `ordering` string
- `page` integer
- `scopes_logical_operator` 'and' | 'or'
- `search` string
- `status` integer[]
- `team` string[]

## Response `200`

- PaginatedScanningAgentSchemaList
  - `count` integer — Total number of results.
  - `page_total` integer — Total number of pages.
  - `page` integer — Number of the current page. The first page is 1. Defaults to 1 if no specific page is requested.
  - `length` integer — Number of results returned per page.
  - `results` ScanningAgentSchema[]
    - `id` string, required
    - `name` string, required
    - `installer_generated` boolean, required
    - `teams` SimpleTeam[], nullable
      - `id` string — A unique Base58 value identifying this object.
      - `name` string, required
    - `online` boolean, required
    - `fallback` boolean, required
    - `rx_bytes` integer, required
    - `tx_bytes` integer, required
    - `latest_handshake` integer, required

## Other responses

- `400`
- `401`
- `500`

---

[API](https://skmtc.net/probely/apis/snyk-api-web-s-api-reference-documentation.md) · [All operations](https://skmtc.net/probely/apis/snyk-api-web-s-api-reference-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/probely/snyk-api-web-s-api-reference-documentation/versions/e29879bff01b/schema)