---
title: "Get list of agent hosts"
method: GET
path: "/agent/hosts"
tags: ["AGENT PRIVATE ROUTES"]
---

# Get list of agent hosts

`GET /agent/hosts`

This API retrieves a paginated list of registered agent hosts. Optionally, it can include Kubernetes cluster hosts if specified.

## Query parameters

- `shouldGetK8sClusters` boolean
- `searchQuery` string
- `page` integer
- `recordsPerPage` integer

## Response `202`

List of hosts with pagination info

- string[]

## Other responses

- `401` — Unauthorized or invalid token
- `500` — Internal server error

---

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