---
title: Händler-Linkpaket abrufen
description: "Alle Links veröffentlichter Pässe eines Produkts plus Modellseite: JSON seitenweise, CSV oder ZIP bis 50.000 Zeilen. Für Händleranfragen (ESPR Art. 10(3)(b))."
canonical: "https://www.tracepass.eu/de/docs/get-product-links"
locale: de
source: "https://www.tracepass.eu/de/docs/get-product-links"
---

# Händler-Linkpaket abrufen

> Alle Links veröffentlichter Pässe eines Produkts plus Modellseite: JSON seitenweise, CSV oder ZIP bis 50.000 Zeilen. Für Händleranfragen (ESPR Art. 10(3)(b)).

```http
GET /api/v1/products/{id}/links
```

Liefert das Händler-Linkpaket eines Produkts: jeden veröffentlichten Pass mit Seriennummer, Pass-URL und Status, plus die URL der Modellseite des Produkts. Es ist die Ein-Aufruf-Antwort auf eine Händleranfrage nach ESPR Artikel 10 Absatz 3 Buchstabe b, die einen Weblink oder eine Kopie des Datenträgers binnen fünf Arbeitstagen nach der Anfrage verlangt.

Aufgelistet werden nur veröffentlichte Pässe; Entwürfe, Pässe in Prüfung, suspendierte, abgelaufene, archivierte und gelöschte bleiben außen vor. Die URLs nutzen die verifizierte eigene Domain des Unternehmens, falls vorhanden. Die Modellseite (`/01/{gtin}`) ist eine öffentliche Seite nur mit den Werten, die für jede Einheit gelten: Name, Beschreibung und Bilder des Produkts, der Kontakt des Unternehmens und die öffentlichen Feldwerte, die in jedem veröffentlichten Pass identisch sind. Sie enthält keine Daten einer einzelnen Einheit und keine zugangsbeschränkten Daten. Sie ist kein Pass. Ein Produkt, dessen Pässe nicht GS1-adressiert sind, hat keine Modellseite, und `models` ist leer.

`format=json` (Standard) ist seitenweise in Pass-ID-Reihenfolge, höchstens `limit` Zeilen pro Seite (Standard 1000, Maximum 5000); übergeben Sie `nextCursor` der Antwort als `cursor` für die nächste Seite. `format=csv` streamt jeden veröffentlichten Pass mit den Spalten `serial`, `passport_url`, `status`. Es ist ein Maschinenformat, öffnen Sie es also nicht unbedacht in einer Tabellenkalkulation. `format=zip` enthält `passports.csv` (tabellenkalkulationssicher), `message.txt` (ein kurzer Text zum Weiterleiten) und den QR der Modellseite als `model-qr-{gtin}.png`, und antwortet ab 50.000 veröffentlichten Pässen mit 413 `pack_too_large`; nutzen Sie dann `csv`. Das JSON enthält je Pass `qrApiUrl`, eine API-Route, die Ihre Zugangsdaten braucht, daher steht sie in keiner Datei für Händler. Zählt als ein v1-Lesezugriff.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Authorization` | header | string | yes | `Bearer <token>` — entweder ein `tp_` API-Schlüssel (Developer → API Keys; am einfachsten, für Server-zu-Server) oder ein OAuth-2.0-Access-Token (Developer → OAuth Apps; für nutzerautorisierte Apps, scoped und widerrufbar). Die Authentication-Seite enthält den vollständigen OAuth-Flow und die Scope-Liste. |
| `id` | path | string (24 hex chars) | yes | Produkt-ID. |
| `format` | query | string | no | `json` (Standard), `csv` oder `zip`. |
| `limit` | query | integer (1–5000) | no | Zeilen pro Seite, Standard 1000. Nur `json`. |
| `cursor` | query | string | no | Das `nextCursor` der vorherigen Seite. Nur `json`. |

## Examples

```bash
# Paged JSON (default)
curl -sS "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links?limit=1000" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

# The file to send to a dealer: passports.csv, message.txt and the model page QR
curl -sS "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links?format=zip" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o dealer-pack.zip
```

```typescript
const base = `https://app.tracepass.eu/api/v1/products/${id}/links`;
const headers = { Authorization: `Bearer ${process.env.TRACEPASS_API_KEY}` };

let cursor: string | null = null;
do {
  const url = new URL(base);
  if (cursor) url.searchParams.set("cursor", cursor);
  const res = await fetch(url, { headers });
  if (!res.ok) throw new Error(`Links failed: ${res.status}`);
  const page = await res.json();
  for (const p of page.passports) console.log(p.serial, p.passportUrl);
  cursor = page.nextCursor;
} while (cursor);
```

```python
import os, requests

url = f"https://app.tracepass.eu/api/v1/products/{product_id}/links"
headers = {"Authorization": f"Bearer {os.environ['TRACEPASS_API_KEY']}"}
params = {}
while True:
    res = requests.get(url, headers=headers, params=params)
    res.raise_for_status()
    page = res.json()
    for p in page["passports"]:
        print(p["serial"], p["passportUrl"])
    if not page["nextCursor"]:
        break
    params["cursor"] = page["nextCursor"]
```

## Responses

### 200 — JSON-Seite

```json
{
  "productId": "6650a1b2c3d4e5f6a7b8c9d0",
  "productName": "Li-Ion 48V Battery Pack",
  "productModel": "BP-48V-100",
  "models": [
    {
      "gtin": "09506000134352",
      "modelUrl": "https://id.tracepass.eu/01/09506000134352",
      "qrApiUrl": "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links/model-qr?gtin=09506000134352"
    }
  ],
  "passports": [
    {
      "passportId": "6650b2c3d4e5f6a7b8c9d0e1",
      "serial": "SN-0001",
      "passportUrl": "https://id.tracepass.eu/01/09506000134352/21/SN-0001",
      "qrApiUrl": "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/qr?format=png",
      "status": "published"
    }
  ],
  "nextCursor": null
}
```

### 400 — Ungültiger Parameter

```json
{ "error": "invalid_limit", "message": "limit must be an integer from 1 to 5000" }
```

### 404 — Nicht gefunden

```json
{ "error": "Product not found" }
```

### 413 — Paket zu groß

```json
{ "error": "pack_too_large", "message": "…", "max": 50000 }
```

## Related

- [QR der Modellseite rendern](https://www.tracepass.eu/de/docs/get-product-model-qr.md)
- [Einzelnes Produkt lesen](https://www.tracepass.eu/de/docs/get-product.md)
