---
title: "Получить статус задания печати"
description: "Проверяйте задание CloudPrint, пока оно не перейдёт в конечный статус printed, failed или cancelled."
---
<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, пока оно не перейдёт в конечный статус printed, failed или cancelled.</p>

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

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

Проверяйте задание CloudPrint, пока оно не перейдёт в конечный статус printed, failed или cancelled.

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

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

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

## Запрос

**Основной адрес API:** `https://public-api.cloudprint.me/api/v1/print-jobs/{printJobId}`

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

| Имя | Расположение | Тип | Обязательно | Описание | Ограничения |
| --- | --- | --- | --- | --- | --- |
| `printJobId` | path | `string (uuid)` | да | Поле контракта API; учитывайте указанные тип и ограничения. | — |

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

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

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

#### cURL

```bash
curl -sS https://public-api.cloudprint.me/api/v1/print-jobs/55555555-5555-4555-8555-555555555555 \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

## Ответ

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

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

| Имя | Тип | Обязательно | Описание | Ограничения |
| --- | --- | --- | --- | --- |
| `print_job_id` | `string (uuid)` | да | Стабильный UUID задания печати; сохраните его для проверки статуса и поддержки. | — |
| `document_id` | `string (uuid)` | да | Стабильный UUID, возвращаемый после успешной загрузки документа. | — |
| `document_mime_type` | `string` | да | MIME-тип переданного документа. | example: `"application/pdf"` |
| `document_format` | `string` | да | Явный формат печати, например `pdf` или `raw`. | enum: `pdf`, `raw`; example: `"pdf"` |
| `document_raw_language` | `string \| null` | да | Язык команд RAW-документа, например ZPL или EPL. | enum: `tspl`, `zpl`, `cpcl`, `escpos`; example: `null` |
| `printer_id` | `string (uuid)` | да | Стабильный UUID целевого принтера в CloudPrint. | — |
| `status` | `string` | да | Текущее состояние ресурса или процесса; учитывайте допустимые значения конкретного метода. | enum: `pending`, `reserved`, `printing`, `printed`, `failed`, `cancelled`; example: `"pending"` |
| `copies` | `integer` | да | Количество копий, которое CloudPrint передаст принтеру. | min: 1; max: 99; example: `1` |
| `intent` | `string` | да | Бизнес-назначение задания для диагностики и подходящих настроек по умолчанию. | enum: `document`, `shipping_label`, `product_label`, `invoice`, `packing_slip`, `a4_document`, `receipt`; example: `"shipping_label"` |
| `color_mode` | `string` | да | Режим цвета; `default` использует настройку принтера. | enum: `default`, `monochrome`, `color`; example: `"default"` |
| `duplex_mode` | `string` | да | Запрошенный односторонний или двусторонний режим печати. | enum: `default`, `simplex`, `duplex_long_edge`, `duplex_short_edge`; example: `"default"` |
| `media_width_mm` | `number \| null` | да | Запрошенная ширина носителя или этикетки в миллиметрах. | min: 1; max: 2000; example: `58` |
| `media_height_mm` | `number \| null` | да | Запрошенная высота носителя или этикетки в миллиметрах. | min: 1; max: 2000; example: `40` |
| `dpi` | `integer \| null` | да | Целевое разрешение печати в точках на дюйм; используйте значение принтера. | min: 72; max: 2400; example: `203` |
| `scale_mode` | `string` | да | Определяет, сохранять размер документа или вписать его в носитель. | enum: `none`, `fit`; example: `"none"` |
| `orientation` | `string` | да | Ориентация страницы; `default` использует настройку принтера. | enum: `default`, `portrait`, `landscape`; example: `"default"` |
| `offset_x_mm` | `number` | да | Горизонтальное смещение печати в миллиметрах. | min: -2000; max: 2000; example: `0` |
| `offset_y_mm` | `number` | да | Вертикальное смещение печати в миллиметрах. | min: -2000; max: 2000; example: `0` |
| `margin_top_mm` | `number` | да | Дополнительное поле печати в миллиметрах. | min: 0; max: 2000; example: `0` |
| `margin_right_mm` | `number` | да | Дополнительное поле печати в миллиметрах. | min: 0; max: 2000; example: `0` |
| `margin_bottom_mm` | `number` | да | Дополнительное поле печати в миллиметрах. | min: 0; max: 2000; example: `0` |
| `margin_left_mm` | `number` | да | Дополнительное поле печати в миллиметрах. | min: 0; max: 2000; example: `0` |
| `created_at` | `string (date-time)` | да | Временная метка CloudPrint в формате ISO 8601. | — |
| `reserved_at` | `string \| null (date-time)` | да | Временная метка CloudPrint в формате ISO 8601. | — |
| `started_at` | `string \| null (date-time)` | да | Временная метка CloudPrint в формате ISO 8601. | — |
| `completed_at` | `string \| null (date-time)` | да | Временная метка CloudPrint в формате ISO 8601. | — |
| `failure_reason` | `string \| null` | да | Машиночитаемая или диагностическая причина неудачной печати. | — |

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

```json
{
  "print_job_id": "11111111-1111-4111-8111-111111111111",
  "document_id": "11111111-1111-4111-8111-111111111111",
  "document_mime_type": "application/pdf",
  "document_format": "pdf",
  "document_raw_language": null,
  "printer_id": "11111111-1111-4111-8111-111111111111",
  "status": "pending",
  "copies": 1,
  "intent": "shipping_label",
  "color_mode": "default",
  "duplex_mode": "default",
  "media_width_mm": 58,
  "media_height_mm": 40,
  "dpi": 203,
  "scale_mode": "none",
  "orientation": "default",
  "offset_x_mm": 0,
  "offset_y_mm": 0,
  "margin_top_mm": 0,
  "margin_right_mm": 0,
  "margin_bottom_mm": 0,
  "margin_left_mm": 0,
  "created_at": "2026-08-06T12:00:00Z",
  "reserved_at": null,
  "started_at": null,
  "completed_at": null,
  "failure_reason": null
}
```

## Ошибки

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

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

- Проверяйте состояние с разумным интервалом и остановитесь на конечном статусе `printed`, `failed` или `cancelled`.
- Сохраняйте `failure_reason`, `print_job_id` и `X-Request-Id` для поддержки.
- Не создавайте новое задание только из-за превышения времени ожидания одного запроса статуса.

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

<div class="docs-card-grid"><a class="docs-card" href="/docs/api/v1/print-jobs/create/"><strong>Создать задание печати</strong><span>Отправьте загруженный документ CloudPrint на выбранный принтер с идемпотентностью и явными параметрами.</span></a>
<a class="docs-card" href="/docs/api/v1/print-jobs/list/"><strong>Получить список заданий печати</strong><span>Получите последние задания CloudPrint с курсорной пагинацией для интерфейсов и поддержки.</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>