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

# List Agents

`GET /agents`

The endpoint returns a list of agents by various filters.

## Query parameters

- `filter[agent]` string
- `filter[agent-pool]` string
- `filter[name]` string
- `filter[mtls-certificate-fingerprint]` string
- `filter[mtls-certificate-status]` string
- `filter[mtls-certificate-not-valid-after]` string
- `page[number]` string
- `page[size]` string
- `include` string[]
- `sort` string[]

## Response `200`

Success.

## Other responses

- `404` — User not authorized.
- `4XX` — Client error.
- `5XX` — Server error.

---

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