---
title: Leggere un singolo prodotto
description: Leggere un prodotto per ID. Restituisce il documento completo — valori di campo predefiniti, URL immagini, riferimento template e passportCount attuale.
canonical: "https://www.tracepass.eu/it/docs/get-product"
locale: it
source: "https://www.tracepass.eu/it/docs/get-product"
---

# Leggere un singolo prodotto

> Leggere un prodotto per ID. Restituisce il documento completo — valori di campo predefiniti, URL immagini, riferimento template e passportCount attuale.

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

Legge un prodotto per ID. Restituisce il documento completo, inclusi i valori predefiniti dei campi, gli URL delle immagini, il riferimento al template e il `passportCount` corrente. 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 | ObjectId | yes | ID del prodotto. |

## Examples

```bash
curl -sS https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0 \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"
```

```typescript
const res = await fetch(`https://app.tracepass.eu/api/v1/products/${id}`, {
  headers: { Authorization: `Bearer ${process.env.TRACEPASS_API_KEY}` },
});
if (res.status === 404) return null;
if (!res.ok) throw new Error(`Read failed: ${res.status}`);
const product = await res.json();
```

```python
import os, requests
res = requests.get(
    f"https://app.tracepass.eu/api/v1/products/{product_id}",
    headers={"Authorization": f"Bearer {os.environ['TRACEPASS_API_KEY']}"},
)
if res.status_code == 404:
    raise SystemExit("Not found")
res.raise_for_status()
product = res.json()
```

## Responses

### 200 — OK

```json
{
  "_id": "6650a1b2c3d4e5f6a7b8c9d0",
  "name": "Li-Ion 48V Battery Pack",
  "model": "BP-48V-100",
  "category": "batteries",
  "templateId": "6650a1b2c3d4e5f6a7b8c9d1",
  "defaultFieldValues": {
    "batteryChemistry": "NMC",
    "nominalVoltage": 48
  },
  "imageUrls": [
    "https://cdn.example.com/products/battery-pack-hero.jpg"
  ],
  "passportCount": 12,
  "status": "active",
  "createdAt": "2026-04-10T14:30:00.000Z",
  "updatedAt": "2026-04-12T09:15:00.000Z"
}
```

### 404 — Non trovato

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

## Related

- [Elencare i prodotti](https://www.tracepass.eu/it/docs/list-products.md)
- [Aggiornare un prodotto](https://www.tracepass.eu/it/docs/update-product.md)