---
title: Get the dealer link pack
description: "Every published passport link of a product plus its model page link: paged JSON, CSV or a ZIP of up to 50,000 rows. For a dealer's request (ESPR Art. 10(3)(b))."
canonical: "https://www.tracepass.eu/docs/get-product-links"
locale: en
source: "https://www.tracepass.eu/docs/get-product-links"
---

# Get the dealer link pack

> Every published passport link of a product plus its model page link: paged JSON, CSV or a ZIP of up to 50,000 rows. For a dealer's request (ESPR Art. 10(3)(b)).

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

Returns the dealer link pack of a product: every published passport with its serial, passport URL and status, plus the product's model page URL. It is the one-call answer to a dealer's request under ESPR Article 10(3)(b), which asks for a webpage link or a copy of the data carrier within five working days of the request.

Only published passports are listed; draft, in-review, suspended, expired, archived and deleted passports are left out. URLs use the company's verified custom domain when it has one. The model page (`/01/{gtin}`) is a public page with only the values true of every unit: the product's name, description and images, the company's contact, and the public field values identical in every published passport. It carries no data of a single unit and no restricted data. It is not a passport. A product whose passports are not GS1-addressed has no model page, and `models` is empty.

`format=json` (default) is paged in passport-id order, at most `limit` rows per page (default 1000, maximum 5000); pass the response's `nextCursor` as `cursor` for the next page. `format=csv` streams every published passport with the columns `serial`, `passport_url`, `status`. It is a machine format, so do not open it in a spreadsheet without care. `format=zip` holds `passports.csv` (spreadsheet-safe), `message.txt` (a short text to forward) and the model page QR as `model-qr-{gtin}.png`, and answers 413 `pack_too_large` above 50,000 published passports; use `csv` then. The JSON carries `qrApiUrl` for each passport, an API route that needs your credentials, so it is in no file meant for a dealer. Counts as one v1 read.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Authorization` | header | string | yes | `Bearer <token>` — either a `tp_` API key (Developer → API Keys; simplest, for server-to-server) or an OAuth 2.0 access token (Developer → OAuth Apps; for user-authorized apps, scoped + revocable). The Authentication page has the full OAuth flow and scope list. |
| `id` | path | string (24 hex chars) | yes | Product ID. |
| `format` | query | string | no | `json` (default), `csv` or `zip`. |
| `limit` | query | integer (1–5000) | no | Rows per page, default 1000. `json` only. |
| `cursor` | query | string | no | The previous page's `nextCursor`. `json` only. |

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

```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 — Invalid parameter

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

### 404 — Not found

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

### 413 — Pack too large

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

## Related

- [Render the model page QR](https://www.tracepass.eu/docs/get-product-model-qr.md)
- [Get a single product](https://www.tracepass.eu/docs/get-product.md)
