---
title: Ottenere il pacchetto di link per rivenditori
description: "Link dei passaporti pubblicati di un prodotto più pagina del modello: JSON paginato, CSV o ZIP fino a 50.000 righe. Per richieste dei rivenditori (ESPR)."
canonical: "https://www.tracepass.eu/it/docs/get-product-links"
locale: it
source: "https://www.tracepass.eu/it/docs/get-product-links"
---

# Ottenere il pacchetto di link per rivenditori

> Link dei passaporti pubblicati di un prodotto più pagina del modello: JSON paginato, CSV o ZIP fino a 50.000 righe. Per richieste dei rivenditori (ESPR).

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

Restituisce il pacchetto di link per rivenditori di un prodotto: ogni passaporto pubblicato con seriale, URL del passaporto e stato, più l'URL della pagina del modello del prodotto. È la risposta in una sola chiamata a una richiesta di un rivenditore ai sensi dell'articolo 10, paragrafo 3, lettera b) dell'ESPR, che chiede un link a una pagina web o una copia del supporto dati entro cinque giorni lavorativi dalla richiesta.

Sono elencati solo i passaporti pubblicati; bozze, passaporti in revisione, sospesi, scaduti, archiviati e eliminati restano fuori. Gli URL usano il dominio personalizzato verificato dell'azienda, se ne ha uno. La pagina del modello (`/01/{gtin}`) è una pagina pubblica con i soli valori veri per ogni unità: nome, descrizione e immagini del prodotto, il contatto dell'azienda e i valori pubblici dei campi identici in ogni passaporto pubblicato. Non contiene dati di una singola unità né dati ad accesso limitato. Non è un passaporto. Un prodotto i cui passaporti non sono indirizzati con GS1 non ha pagina del modello e `models` è vuoto.

`format=json` (default) è paginato in ordine di ID del passaporto, al massimo `limit` righe per pagina (default 1000, massimo 5000); passate il `nextCursor` della risposta come `cursor` per la pagina successiva. `format=csv` trasmette in streaming ogni passaporto pubblicato con le colonne `serial`, `passport_url`, `status`. È un formato per macchine, quindi non apritelo in un foglio di calcolo senza cautela. `format=zip` contiene `passports.csv` (sicuro per i fogli di calcolo), `message.txt` (un breve testo da inoltrare) e il QR della pagina del modello come `model-qr-{gtin}.png`, e risponde 413 `pack_too_large` oltre 50.000 passaporti pubblicati; usate allora `csv`. Il JSON riporta `qrApiUrl` per ogni passaporto, una route API che richiede le vostre credenziali, quindi non compare in nessun file destinato a un rivenditore. Conta come una lettura v1.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Authorization` | header | string | yes | `Bearer <token>` — una chiave API `tp_` (Developer → API Keys; più semplice, per server-to-server) oppure un access token OAuth 2.0 (Developer → OAuth Apps; per app autorizzate dall'utente, scoped e revocabili). La pagina Authentication contiene il flusso OAuth completo e l'elenco degli scopes. |
| `id` | path | string (24 hex chars) | yes | ID del prodotto. |
| `format` | query | string | no | `json` (default), `csv` o `zip`. |
| `limit` | query | integer (1–5000) | no | Righe per pagina, default 1000. Solo `json`. |
| `cursor` | query | string | no | Il `nextCursor` della pagina precedente. Solo `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 — Pagina JSON

```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 — Parametro non valido

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

### 404 — Non trovato

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

### 413 — Pacchetto troppo grande

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

## Related

- [Renderizzare il QR della pagina del modello](https://www.tracepass.eu/it/docs/get-product-model-qr.md)
- [Leggere un singolo prodotto](https://www.tracepass.eu/it/docs/get-product.md)
