---
title: Elencare i template di categoria
description: Elencate ogni template di categoria DPP — numero di campi, campi obbligatori, regolamento e versione. Scoprite i requisiti prima di costruire un passaporto.
canonical: "https://www.tracepass.eu/it/docs/list-templates"
locale: it
source: "https://www.tracepass.eu/it/docs/list-templates"
---

# Elencare i template di categoria

> Elencate ogni template di categoria DPP — numero di campi, campi obbligatori, regolamento e versione. Scoprite i requisiti prima di costruire un passaporto.

```http
GET /api/v1/templates
```

Elenca i template di categoria DPP — gli schemi di campi normativi (batteria, tessile, elettronica, …). Ogni voce indica la chiave della categoria, la sua etichetta inglese, il numero totale e obbligatorio di campi, il regolamento applicabile e la versione del template. I template sono dati di riferimento globali, non legati all'azienda.

Usatelo per scoprire cosa richiede un passaporto conforme in una categoria *prima* di creare prodotti e passaporti. Per leggere lo schema completo campo per campo di una categoria, chiamate `GET /api/v1/templates/{category}`.

È una chiamata di scoperta a bassa frequenza, quindi non conta sul limite giornaliero di letture. L'autenticazione è una chiave API `tp_` o un token OAuth con lo scope `passports:read`.

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

## Examples

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

```typescript
const res = await fetch("https://app.tracepass.eu/api/v1/templates", {
  headers: { Authorization: `Bearer ${process.env.TRACEPASS_API_KEY}` },
});
const { templates } = await res.json();
```

```python
import os, requests
res = requests.get(
    "https://app.tracepass.eu/api/v1/templates",
    headers={"Authorization": f"Bearer {os.environ['TRACEPASS_API_KEY']}"},
)
res.raise_for_status()
templates = res.json()["templates"]
```

## Responses

### 200 — Successo

```json
{
  "templates": [
    {
      "category": "battery",
      "categoryLabel": "Battery",
      "fieldCount": 93,
      "requiredFieldCount": 64,
      "regulation": "EU Battery Regulation 2023/1542",
      "version": 3
    },
    {
      "category": "textile",
      "categoryLabel": "Textile",
      "fieldCount": 61,
      "requiredFieldCount": 38,
      "regulation": "ESPR 2024/1781",
      "version": 2
    }
  ]
}
```

## Related

- [Leggere un template di categoria](https://www.tracepass.eu/it/docs/get-template.md)
- [Creare un prodotto](https://www.tracepass.eu/it/docs/create-product.md)