---
title: "Получить список агентов печати"
description: "Получите список агентов CloudPrint в аккаунте и проверьте их статус, версию и состояние обновления."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/docs/">Документация CloudPrint</a><span aria-hidden="true">/</span><span>Справочник API</span></nav>

# Получить список агентов печати

<p class="docs-lead">Получите список агентов CloudPrint в аккаунте и проверьте их статус, версию и состояние обновления.</p>

<div class="api-endpoint-summary"><span class="api-method api-method-get">GET</span><code>/api/v1/agents</code><span><strong>Версия API:</strong> v1</span><span><strong>operationId:</strong> <code>listAgents</code></span><a href="/docs/api/v1/agents/list/index.md">Открыть в Markdown</a></div>

## Назначение метода

Получите список агентов CloudPrint в аккаунте и проверьте их статус, версию и состояние обновления.

## Авторизация

Передавайте короткоживущий токен в `Authorization: Bearer <access_token>`.

**Обязательные разрешения:** `agents:read`

## Запрос

**Основной адрес API:** `https://public-api.cloudprint.me/api/v1/agents`

### Параметры

| Имя | Расположение | Тип | Обязательно | Описание | Ограничения |
| --- | --- | --- | --- | --- | --- |
| `limit` | query | `integer` | нет | Поле контракта API; учитывайте указанные тип и ограничения. | min: 1; max: 100; default: `50` |
| `cursor` | query | `string \| null` | нет | Поле контракта API; учитывайте указанные тип и ограничения. | — |

### Тело запроса

У метода нет тела запроса.

### Примеры запросов

#### cURL

```bash
curl -sS 'https://public-api.cloudprint.me/api/v1/agents?limit=50' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

## Ответ

**HTTP-статус:** `200` — Запрос выполнен.

### Поля ответа

| Имя | Тип | Обязательно | Описание | Ограничения |
| --- | --- | --- | --- | --- |
| `agents` | `array` | да | Агенты, зарегистрированные в текущем аккаунте CloudPrint. | — |
| `next_cursor` | `string \| null` | да | Непрозрачный cursor следующей страницы; передавайте его без изменений. | — |

### Пример ответа

```json
{
  "agents": [
    {
      "agent_id": "11111111-1111-4111-8111-111111111111",
      "name": "Warehouse PC agent",
      "status": "online",
      "agent_instance_id": null,
      "hostname": null,
      "version": null,
      "update": {
        "status": "available",
        "current_version": "0.1.0",
        "latest_version": "0.1.1",
        "minimum_supported_version": "0.1.0",
        "channel": "stable",
        "required": false
      },
      "last_seen_at": null
    }
  ],
  "next_cursor": null
}
```

## Ошибки

| HTTP-статус | Описание |
| --- | --- |
| `401` | Авторизация отсутствует или недействительна. |
| `403` | Для операции недостаточно разрешений. |
| `422` | Поля запроса не прошли проверку. |
| `429` | Превышен лимит запросов; учитывайте Retry-After. |
| `500` | Внутренняя ошибка CloudPrint. |

## Рекомендации по интеграции

- Статус агента — диагностическая информация, а не ключ маршрутизации на принтер.
- Проверяйте состояние обновления агента до диагностики принтера или документа.

## Связанная документация

<div class="docs-card-grid"><a class="docs-card" href="/docs/api/agents-and-printers/"><strong>Подключение агента и выбор принтера</strong><span>Установите агент CloudPrint, получите локальные очереди печати и сохраните стабильный printer_id с учётом возможностей принтера.</span></a>
<a class="docs-card" href="/docs/api/v1/printers/list/"><strong>Получить список доступных принтеров</strong><span>Получите принтеры подключённых агентов CloudPrint и выберите стабильный printer_id для сценария печати.</span></a>
<a class="docs-card" href="/docs/troubleshooting/"><strong>Диагностика агентов, принтеров и заданий</strong><span>Находите причину ошибок CloudPrint по идентификатору запроса, статусу задания, подключению агента, возможностям принтера и коду API.</span></a></div>

<nav class="docs-resource-links" aria-label="Следующие шаги"><a href="/docs/api/v1/explorer/">OpenAPI</a><a href="https://my.cloudprint.by">Открыть кабинет</a><a href="/docs/legal/privacy/">Политика конфиденциальности</a><a href="/docs/legal/terms/">Условия использования</a><a href="/docs/legal/payments-and-refunds/">Оплата и возврат</a><a href="/docs/legal/data-processing/">DPA</a></nav>