---
title: "Status eines Druckauftrags abrufen"
description: "Fragen Sie den Status eines Druckauftrags ab, bis er printed, failed oder cancelled lautet."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/de/docs/">CloudPrint-Dokumentation</a><span aria-hidden="true">/</span><span>API-Referenz</span></nav>

# Status eines Druckauftrags abrufen

<p class="docs-lead">Fragen Sie den Status eines Druckauftrags ab, bis er printed, failed oder cancelled lautet.</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-Version:</strong> v1</span><span><strong>operationId:</strong> <code>getPrintJob</code></span><a href="/de/docs/api/v1/print-jobs/get/index.md">Als Markdown anzeigen</a></div>

## Funktion dieser Methode

Fragen Sie den Status eines Druckauftrags ab, bis er printed, failed oder cancelled lautet.

## Authentifizierung

Senden Sie ein kurzlebiges Token in `Authorization: Bearer <access_token>`.

**Erforderliche Scopes:** `print_jobs:read`

## Anfrage

**Produktions-URL:** `https://public-api.cloudprint.me/api/v1/print-jobs/{printJobId}`

### Parameter

| Name | Position | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- | --- |
| `printJobId` | path | `string (uuid)` | ja | Stabile UUID des Druckauftrags im Pfad. | — |
| `X-Request-Id` | header | `string` | nein | Optionale Kennung zur Anfrageverfolgung; CloudPrint gibt einen sicheren Wert im Antwort-Header zurück. | maxLength: 128; example: `"order-100045-attempt-1"` |

### Anfrageinhalt

Die Methode hat keinen Anfrageinhalt.

### Anfragebeispiele

#### cURL

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

## Antwort

**HTTP-Status:** `200` — Anfrage erfolgreich.

### Antwortfelder

| Name | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- |
| `print_job_id` | `string (uuid)` | ja | Stabile UUID des Druckauftrags; für Statusabfragen und Support speichern. | — |
| `document_id` | `string (uuid)` | ja | Stabile UUID, die nach einem erfolgreichen Dokument-Upload zurückgegeben wird. | — |
| `document_mime_type` | `string` | ja | MIME-Typ des bereitgestellten Dokuments. | example: `"application/pdf"` |
| `document_format` | `string` | ja | Explizites Druckformat, beispielsweise `pdf` oder `raw`. | enum: `pdf`, `raw`; example: `"pdf"` |
| `document_raw_language` | `string \| null` | ja | Druckerbefehlssprache der RAW-Daten, beispielsweise ZPL oder EPL. | enum: `tspl`, `zpl`, `cpcl`, `escpos`; example: `null` |
| `printer_id` | `string (uuid)` | ja | Stabile CloudPrint-UUID des Zieldruckers. | — |
| `status` | `string` | ja | Aktueller Ressourcen- oder Prozessstatus; verwenden Sie die Enum-Werte der jeweiligen Methode. | enum: `pending`, `reserved`, `printing`, `printed`, `failed`, `cancelled`; example: `"pending"` |
| `copies` | `integer` | ja | Anzahl der Exemplare, die CloudPrint beim Drucker anfordert. | min: 1; max: 99; example: `1` |
| `intent` | `string` | ja | Geschäftlicher Zweck des Druckauftrags für die Diagnose und sinnvolle Standardwerte. | enum: `document`, `shipping_label`, `product_label`, `invoice`, `packing_slip`, `a4_document`, `receipt`; example: `"shipping_label"` |
| `color_mode` | `string` | ja | Gewünschter Farbmodus; `default` verwendet die Druckereinstellungen. | enum: `default`, `monochrome`, `color`; example: `"default"` |
| `duplex_mode` | `string` | ja | Gewünschter ein- oder beidseitiger Druckmodus. | enum: `default`, `simplex`, `duplex_long_edge`, `duplex_short_edge`; example: `"default"` |
| `media_width_mm` | `number \| null` | ja | Gewünschte Breite des Druckmediums oder Etiketts in Millimetern. | min: 1; max: 2000; example: `58` |
| `media_height_mm` | `number \| null` | ja | Gewünschte Höhe des Druckmediums oder Etiketts in Millimetern. | min: 1; max: 2000; example: `40` |
| `dpi` | `integer \| null` | ja | Zielauflösung in Punkten pro Zoll; verwenden Sie einen vom Drucker unterstützten Wert. | min: 72; max: 2400; example: `203` |
| `scale_mode` | `string` | ja | Legt fest, ob das Dokument seine Größe behält oder an das Zielmedium angepasst wird. | enum: `none`, `fit`; example: `"none"` |
| `orientation` | `string` | ja | Gewünschte Seitenausrichtung; `default` verwendet die Druckereinstellungen. | enum: `default`, `portrait`, `landscape`; example: `"default"` |
| `offset_x_mm` | `number` | ja | Horizontaler Druckversatz in Millimetern. | min: -2000; max: 2000; example: `0` |
| `offset_y_mm` | `number` | ja | Vertikaler Druckversatz in Millimetern. | min: -2000; max: 2000; example: `0` |
| `margin_top_mm` | `number` | ja | Zusätzlicher Druckrand in Millimetern. | min: 0; max: 2000; example: `0` |
| `margin_right_mm` | `number` | ja | Zusätzlicher Druckrand in Millimetern. | min: 0; max: 2000; example: `0` |
| `margin_bottom_mm` | `number` | ja | Zusätzlicher Druckrand in Millimetern. | min: 0; max: 2000; example: `0` |
| `margin_left_mm` | `number` | ja | Zusätzlicher Druckrand in Millimetern. | min: 0; max: 2000; example: `0` |
| `created_at` | `string (date-time)` | ja | Von CloudPrint erfasster ISO-8601-Zeitstempel. | — |
| `reserved_at` | `string \| null (date-time)` | ja | Von CloudPrint erfasster ISO-8601-Zeitstempel. | — |
| `started_at` | `string \| null (date-time)` | ja | Von CloudPrint erfasster ISO-8601-Zeitstempel. | — |
| `completed_at` | `string \| null (date-time)` | ja | Von CloudPrint erfasster ISO-8601-Zeitstempel. | — |
| `failure_reason` | `string \| null` | ja | Maschinenlesbarer oder diagnostischer Grund für einen fehlgeschlagenen Druck. | — |

### Beispielantwort

```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": "2026-08-06T12:00:00Z",
  "started_at": "2026-08-06T12:00:00Z",
  "completed_at": "2026-08-06T12:00:00Z",
  "failure_reason": "string"
}
```

## Fehler

| HTTP-Status | Beschreibung |
| --- | --- |
| `401` | Authentifizierung fehlt oder ist ungültig. |
| `403` | Das Token hat nicht die erforderlichen Berechtigungen. |
| `404` | Ressource nicht gefunden. |
| `422` | Mindestens ein Feld ist ungültig. |
| `429` | Anfragelimit überschritten; beachten Sie Retry-After. |
| `500` | Interner CloudPrint-Fehler. |

## Hinweise zur Integration

- Fragen Sie den Status in angemessenen Abständen ab und beenden Sie die Abfrage bei `printed`, `failed` oder `cancelled`.
- Speichern Sie `failure_reason`, `print_job_id` und `X-Request-Id` für den Support.
- Erstellen Sie keinen Ersatzauftrag nur wegen eines Timeouts bei einer Statusabfrage.

## Verwandte Dokumentation

<div class="docs-card-grid"><a class="docs-card" href="/de/docs/api/v1/print-jobs/create/"><strong>Druckauftrag erstellen</strong><span>Senden Sie ein hochgeladenes Dokument mit Idempotenz und expliziten Druckoptionen an einen ausgewählten Drucker.</span></a>
<a class="docs-card" href="/de/docs/api/v1/print-jobs/list/"><strong>Druckaufträge auflisten</strong><span>Rufen Sie aktuelle Druckaufträge mit Cursor-Paginierung für Betriebsansichten und Supportwerkzeuge ab.</span></a>
<a class="docs-card" href="/de/docs/troubleshooting/"><strong>Fehlerbehebung</strong><span>Untersuchen Sie fehlgeschlagene Druckaufträge, ohne versehentlich eine zweite Kopie zu erzeugen.</span></a></div>

<nav class="docs-resource-links" aria-label="Nächste Schritte"><a href="https://cloudprint.me/status/">Dienststatus</a><a href="/de/docs/api/v1/explorer/">OpenAPI</a><a href="https://developer.cloudprint.me">Developer Portal</a><a href="https://my.cloudprint.me">Konto öffnen</a><a href="/docs/legal/privacy/">Datenschutzerklärung</a><a href="/docs/legal/terms/">Nutzungsbedingungen</a><a href="/docs/legal/payments-and-refunds/">Zahlungen und Erstattungen</a><a href="/docs/legal/data-processing/">DPA</a><a href="/docs/legal/service-level-agreement/">Service Level Agreement</a></nav>