---
title: "Druckaufträge auflisten"
description: "Rufen Sie aktuelle Druckaufträge mit Cursor-Paginierung für Betriebsansichten und Supportwerkzeuge ab."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/de/docs/">CloudPrint-Dokumentation</a><span aria-hidden="true">/</span><span>API-Referenz</span></nav>

# Druckaufträge auflisten

<p class="docs-lead">Rufen Sie aktuelle Druckaufträge mit Cursor-Paginierung für Betriebsansichten und Supportwerkzeuge ab.</p>

<div class="api-endpoint-summary"><span class="api-method api-method-get">GET</span><code>/api/v1/print-jobs</code><span><strong>API-Version:</strong> v1</span><span><strong>operationId:</strong> <code>listPrintJobs</code></span><a href="/de/docs/api/v1/print-jobs/list/index.md">Als Markdown anzeigen</a></div>

## Funktion dieser Methode

Rufen Sie aktuelle Druckaufträge mit Cursor-Paginierung für Betriebsansichten und Supportwerkzeuge ab.

## 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`

### Parameter

| Name | Position | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- | --- |
| `limit` | query | `integer` | nein | Höchstzahl der Ressourcen auf einer Ergebnisseite. | min: 1; max: 100; default: `20` |
| `cursor` | query | `string \| null` | nein | Opaker Cursor der angefragten Ergebnisseite; senden Sie ihn unverändert zurück. | — |
| `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?limit=20' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

## Antwort

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

### Antwortfelder

| Name | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- |
| `print_jobs` | `array` | ja | Druckaufträge für das aktuelle Konto und die gewählten Filter. | — |
| `next_cursor` | `string \| null` | ja | Opaker Cursor für die nächste Ergebnisseite; senden Sie ihn unverändert zurück. | — |

### Beispielantwort

```json
{
  "print_jobs": [
    {
      "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"
    }
  ],
  "next_cursor": "string"
}
```

## Fehler

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

## Hinweise zur Integration

- Übergeben Sie `next_cursor` unverändert.
- Nutzen Sie die Liste für Betrieb und Support; bekannte Aufträge rufen Sie direkt per ID ab.

## Verwandte Dokumentation

<div class="docs-card-grid"><a class="docs-card" href="/de/docs/api/v1/print-jobs/get/"><strong>Status eines Druckauftrags abrufen</strong><span>Fragen Sie den Status eines Druckauftrags ab, bis er printed, failed oder cancelled lautet.</span></a>
<a class="docs-card" href="/de/docs/api/print-jobs/"><strong>Druckaufträge erstellen und verfolgen</strong><span>Senden Sie ein Dokument an einen Drucker, vermeiden Sie Duplikate und prüfen Sie das physische Ergebnis.</span></a>
<a class="docs-card" href="/de/docs/api/v1/errors/"><strong>Fehler und Wiederholungen der CloudPrint API</strong><span>Behandeln Sie HTTP-Statuscodes, maschinenlesbare Fehler, Anfragelimits, Anfrageverfolgung und sichere Wiederholungslogik.</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>