---
title: Leggere un singolo passaporto
description: Leggere un passaporto per ID. ?lang risolve ogni campo via la catena viewer-locale; ?format=full aggiunge etichette, unità e livelli di accesso.
canonical: "https://www.tracepass.eu/it/docs/get-passport"
locale: it
source: "https://www.tracepass.eu/it/docs/get-passport"
---

# Leggere un singolo passaporto

> Leggere un passaporto per ID. ?lang risolve ogni campo via la catena viewer-locale; ?format=full aggiunge etichette, unità e livelli di accesso.

```http
GET /api/v1/passports/{id}
```

Legge un passaporto per ID. La risposta predefinita include il passaporto completo — i campi traducibili portano il loro `sourceLocale` e una mappa `translations` per locale. Passate `?lang=<locale>` per far risolvere al server ogni campo attraverso la catena del visualizzatore pubblico (traduzione nel locale del visualizzatore → valore del locale di origine → inglese → primo applicato → fonte universale) e restituire un valore risolto per campo; la mappa `translations` viene rimossa dalle risposte risolte per lang.

Passate `?format=full` per includere inoltre etichette dei campi, unità di misura e livelli di accesso derivati dal template accanto a ogni valore — utile per costruire un visualizzatore personalizzato o un report di controllo. I due parametri di query si combinano: `?format=full&lang=de` restituisce le etichette in DE più i valori risolti in DE.

Indirizzamento alternativo: `GET /api/v1/passports/by-serial/{serial}` restituisce la stessa forma e accetta gli stessi parametri di query. Esiste anche un endpoint `GET /api/v1/passports/{id}/qr` che restituisce un SVG / PNG appena renderizzato del codice QR — utile quando volete il nostro renderer invece di codificare voi stessi `gs1.digitalLinkUri`.

## 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 | ObjectId | yes | ID del passaporto. |
| `format` | query | string | no | Impostate su `full` per includere etichette dei campi, unità di misura e livelli di accesso del template. |
| `lang` | query | string (ISO 639-1) | no | Risolve i valori dei campi a un singolo locale lato server. Uno dei 24 locale dell'UE. |

## Examples

```bash
# Default response — full data, consumer resolves locales itself
curl -sS https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1 \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

# Single-locale response with template labels
curl -sS \
  "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1?format=full&lang=de" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"
```

```typescript
const url = new URL(`https://app.tracepass.eu/api/v1/passports/${id}`);
url.searchParams.set("format", "full");
url.searchParams.set("lang", "de");

const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TRACEPASS_API_KEY}` },
});
if (res.status === 404) return null;
const passport = await res.json();
```

```python
import os, requests
res = requests.get(
    f"https://app.tracepass.eu/api/v1/passports/{passport_id}",
    headers={"Authorization": f"Bearer {os.environ['TRACEPASS_API_KEY']}"},
    params={"format": "full", "lang": "de"},
)
res.raise_for_status()
passport = res.json()
```

## Responses

### 200 — Default

```json
{
  "_id": "6650b2c3d4e5f6a7b8c9d0e1",
  "gs1": {
    "gtin": "04012345000016",
    "serialNumber": "BP-48V-100-000001",
    "digitalLinkUri": "https://id.tracepass.eu/p/01/04012345000016/21/BP-48V-100-000001"
  },
  "status": "published",
  "completionPercentage": 87,
  "fields": {
    "batteryChemistry": {
      "value": "NMC",
      "source": "manual",
      "status": "approved",
      "accessLevel": "public",
      "sourceLocale": "en",
      "translations": {
        "de": { "value": "NMC", "source": "ai-haiku-4.5", "generatedAt": "2026-05-02T10:00:00.000Z" }
      }
    }
  }
}
```

### 200 — ?lang=de

```json
{
  "_id": "6650b2c3d4e5f6a7b8c9d0e1",
  "gs1": { "...": "..." },
  "status": "published",
  "fields": {
    "batteryChemistry": {
      "value": "NMC",
      "source": "manual",
      "sourceLocale": "en"
    }
  }
}
```

### 404 — Non trovato

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

## Related

- [Elencare i passaporti](https://www.tracepass.eu/it/docs/list-passports.md)
- [Creare un passaporto](https://www.tracepass.eu/it/docs/create-passport.md)