---
title: "Получить статистику Partner Program"
description: "Получите количество управляемых аккаунтов, активных агентов и заданий печати за календарный месяц UTC."
---
# Получить статистику Partner Program
Получите количество управляемых аккаунтов, активных агентов и заданий печати за календарный месяц UTC.
GET/partner-api/v1/usageВерсия API: v1operationId:getPartnerUsageОткрыть в Markdown
## Назначение метода
Получите количество управляемых аккаунтов, активных агентов и заданий печати за календарный месяц UTC.
## Авторизация
Передавайте одноразовое JWT-подтверждение Developer Application, подписанное RS256, в `Authorization: Bearer `. Это не токен доступа к Public API.
## Запрос
**Основной адрес API:** `https://public-api.cloudprint.me/partner-api/v1/usage`
### Параметры
| Имя | Расположение | Тип | Обязательно | Описание | Ограничения |
| --- | --- | --- | --- | --- | --- |
| `period` | query | `string` | нет | Поле контракта API; учитывайте указанные тип и ограничения. | example: `"2026-08"` |
### Тело запроса
У метода нет тела запроса.
### Примеры запросов
#### cURL
```bash
curl -sS 'https://public-api.cloudprint.me/partner-api/v1/usage?period=2026-08' \
-H "Authorization: Bearer $APPLICATION_ASSERTION"
```
## Ответ
**HTTP-статус:** `200` — Запрос выполнен.
### Поля ответа
| Имя | Тип | Обязательно | Описание | Ограничения |
| --- | --- | --- | --- | --- |
| `period` | `string` | да | Поле контракта API; учитывайте указанные тип и ограничения. | — |
| `starts_at` | `string (date-time)` | да | Временная метка CloudPrint в формате ISO 8601. | — |
| `ends_at` | `string (date-time)` | да | Временная метка CloudPrint в формате ISO 8601. | — |
| `managed_accounts` | `integer` | да | Поле контракта API; учитывайте указанные тип и ограничения. | min: 0 |
| `active_agents` | `integer` | да | Поле контракта API; учитывайте указанные тип и ограничения. | min: 0 |
| `print_jobs` | `integer` | да | Задания печати текущего аккаунта с учётом фильтров. | min: 0 |
### Пример ответа
```json
{
"period": "string",
"starts_at": "2026-08-06T12:00:00Z",
"ends_at": "2026-08-06T12:00:00Z",
"managed_accounts": 0,
"active_agents": 0,
"print_jobs": 0
}
```
## Ошибки
| HTTP-статус | Описание |
| --- | --- |
| `401` | Авторизация отсутствует или недействительна. |
| `403` | Для операции недостаточно разрешений. |
| `422` | Поля запроса не прошли проверку. |
| `429` | Превышен лимит запросов; учитывайте Retry-After. |
| `500` | Внутренняя ошибка CloudPrint. |
## Рекомендации по интеграции
## Связанная документация