---
title: "Verfügbare Drucker auflisten"
description: "Rufen Sie die über verbundene Agents sichtbaren Drucker ab und wählen Sie eine stabile Drucker-ID für Ihre Integration."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/de/docs/">CloudPrint-Dokumentation</a><span aria-hidden="true">/</span><span>API-Referenz</span></nav>

# Verfügbare Drucker auflisten

<p class="docs-lead">Rufen Sie die über verbundene Agents sichtbaren Drucker ab und wählen Sie eine stabile Drucker-ID für Ihre Integration.</p>

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

## Funktion dieser Methode

Rufen Sie die über verbundene Agents sichtbaren Drucker ab und wählen Sie eine stabile Drucker-ID für Ihre Integration.

## Authentifizierung

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

**Erforderliche Scopes:** `printers:read`

## Anfrage

**Produktions-URL:** `https://public-api.cloudprint.me/api/v1/printers`

### Parameter

| Name | Position | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- | --- |
| `limit` | query | `integer` | nein | Höchstzahl der Ressourcen auf einer Ergebnisseite. | min: 1; max: 100; default: `100` |
| `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/printers?limit=100' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

## Antwort

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

### Antwortfelder

| Name | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- |
| `printers` | `array` | ja | Drucker, die von Agents des aktuellen Kontos erkannt wurden. | — |
| `next_cursor` | `string \| null` | ja | Opaker Cursor für die nächste Ergebnisseite; senden Sie ihn unverändert zurück. | — |

### Beispielantwort

```json
{
  "printers": [
    {
      "printer_id": "11111111-1111-4111-8111-111111111111",
      "agent_id": "11111111-1111-4111-8111-111111111111",
      "local_identifier": "zebra-zd421-usb-001",
      "name": "Warehouse Label Printer",
      "status": "online",
      "last_seen_at": "2026-08-06T12:00:00Z",
      "agent_name": "Warehouse PC agent",
      "agent_hostname": "warehouse-pc",
      "agent_status": "online",
      "agent_last_seen_at": "2026-08-06T12:00:00Z",
      "capabilities": {
        "backend": "windows_native",
        "language_profiles": [
          {
            "language": "zpl",
            "version": "zpl2",
            "supported_commands": [
              "gf"
            ],
            "max_bitmap_width_dots": 812,
            "max_bitmap_height_dots": 1199,
            "compression_modes": [
              "ascii-hex"
            ],
            "codepage": "utf-8"
          }
        ],
        "supports_custom_media": true,
        "supports_orientation": true,
        "supports_copies": true,
        "supports_duplex": true,
        "supports_color": true,
        "supports_scaling": true,
        "supports_offsets": true,
        "supports_printable_area": true,
        "supported_dpi": [
          1
        ],
        "supported_media_sizes": [
          {
            "width_mm": 0,
            "height_mm": 0
          }
        ],
        "supported_feed_types": [
          "gap"
        ],
        "darkness_min": 0,
        "darkness_max": 30,
        "speed_min": 1,
        "speed_max": 14
      },
      "endpoint": {
        "system_print_available": true,
        "raw_passthrough_available": true,
        "configuration_issue": "interactive_output_port",
        "os": "linux",
        "driver_name": "CUPS",
        "port_name": "ipp://printer.local/ipp/print",
        "print_processor": "cups",
        "data_type": "RAW",
        "connection_type": "cups",
        "default_media_profile_id": "string",
        "default_media_profile": {
          "width_mm": 100,
          "height_mm": 150,
          "dpi": 203,
          "orientation": "default",
          "feed_type": "gap",
          "darkness": 15,
          "speed": 4
        }
      }
    }
  ],
  "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

- Speichern Sie `printer_id`; der lokale Warteschlangenname kann sich ändern.
- Prüfen Sie Status, Funktionen und Verbindungsdaten, bevor Sie RAW-, Duplex-, Farb-, Medien- oder DPI-Optionen anbieten.

## Verwandte Dokumentation

<div class="docs-card-grid"><a class="docs-card" href="/de/docs/api/agents-and-printers/"><strong>Agenten und Drucker</strong><span>Verbinden Sie Computer, erkennen Sie Druckerwarteschlangen und wählen Sie stabile Drucker-IDs.</span></a>
<a class="docs-card" href="/de/docs/api/v1/documents/upload/"><strong>Dokument zum Drucken hochladen</strong><span>Laden Sie vor dem Erstellen eines Druckauftrags ein druckfertiges PDF oder explizite RAW-Druckersprachdaten hoch.</span></a>
<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></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>