---
title: Ottieni campi obbligatori
description: Campi obbligatori DPP per categoria di prodotto — citazioni articolo, livelli di accesso, campi previsti e (batterie) flag produttore o fornitore.
canonical: "https://www.tracepass.eu/it/docs/get-required-fields"
locale: it
source: "https://www.tracepass.eu/it/docs/get-required-fields"
---

# Ottieni campi obbligatori

> Campi obbligatori DPP per categoria di prodotto — citazioni articolo, livelli di accesso, campi previsti e (batterie) flag produttore o fornitore.

```http
GET /api/v1/regulatory/required-fields
```

Restituisce i campi obbligatori e previsti per un passaporto della categoria indicata, con l'articolo del regolamento UE su cui si basa ogni campo, il suo livello di accesso (public / restricted / authority) e — per le batterie — se i dati sono solitamente detenuti dal produttore, da un fornitore o dall'operatore. Senza `group` restituisce un riepilogo: conteggi totali per gruppo e livello di accesso, più `requiredByHolder` (solo batterie). Con `group` — l'elenco completo dei campi per quel gruppo.

Disponibile in ogni piano. Conta una risposta normativa sul limite per azienda (~100/giorno, ~30/minuto, condiviso tra dashboard, API e DPP Assistant). Una `category` sconosciuta restituisce 400 `invalid_input` con la lista `allowed`.

Aggiungete `X-Source: assistant` quando chiamate per conto del server MCP del DPP Assistant — la risposta viene firmata dall'assistente e si applica il gate dell'account OAuth (email verificata e non temporanea richiesta). Le chiavi API aggirano il gate.

## 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. |
| `category` | query | string | yes | Chiave categoria template — es. `battery`, `detergents`, `toys`. Restituisce 400 `invalid_input` con la lista `allowed` se non riconosciuto. |
| `group` | query | string | no | Chiave gruppo template (campo `category` su ogni campo template). Se assente restituisce un riepilogo; se presente, l'elenco completo dei campi del gruppo. |
| `subType` | query | string | no | Sottotipo batteria — `EV`, `LMT` o `industrial_gt_2kwh`. Filtra `requiredBy` come il motore di conformità. Restituisce 400 per sottotipo non riconosciuto. |
| `locale` | query | string | no | Lingua risposta per il testo `answer` — `en`, `bg`, `de` o `it`. Predefinito: header `Accept-Language`, poi `en`. |

## Examples

```bash
curl -sS "https://app.tracepass.eu/api/v1/regulatory/required-fields?category=detergents&locale=en" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"
```

```typescript
const res = await fetch(
  "https://app.tracepass.eu/api/v1/regulatory/required-fields?category=detergents&locale=en",
  { headers: { Authorization: `Bearer ${process.env.TRACEPASS_API_KEY}` } }
);
const envelope = await res.json();
// envelope.data.summary.requiredNow — total required fields
// for category=battery, envelope.data.summary.requiredByHolder splits them by who holds the data
```

```python
import os, requests
resp = requests.get(
    "https://app.tracepass.eu/api/v1/regulatory/required-fields",
    params={"category": "detergents", "locale": "en"},
    headers={"Authorization": f"Bearer {os.environ['TRACEPASS_API_KEY']}"},
)
envelope = resp.json()
```

## Responses

### 200 — Riepilogo campi obbligatori

```json
{
  "status": "answered",
  "answer": "detergents passports require 12 fields now, with 4 additional fields anticipated.",
  "locale": "en",
  "data": {
    "category": "detergents",
    "locale": "en",
    "summary": {
      "requiredNow": 12,
      "anticipated": 4,
      "optional": 61,
      "byGroup": {
        "product_id": { "required": 4, "anticipated": 0, "dynamic": 0, "total": 11 },
        "economic_operator": { "required": 6, "anticipated": 0, "dynamic": 0, "total": 11 },
        "composition": { "required": 0, "anticipated": 1, "dynamic": 0, "total": 11 },
        "data_carrier": { "required": 2, "anticipated": 3, "dynamic": 0, "total": 8 },
        "…": {}
      },
      "byAccessTier": { "public": 64, "restricted": 10, "authority": 3 }
    }
  },
  "profileUsed": [],
  "learnable": [],
  "citations": [
    { "celex": "32026R0405", "ref": "Annex VI Part A, point (a)", "url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32026R0405" },
    "…"
  ],
  "ruleIds": [],
  "asOf": "2026-10-09",
  "ruleStatus": "verified",
  "machineTranslated": false,
  "disclaimer": "Regulatory information as of 9 Oct 2026, not legal advice. Check the cited articles before relying on it. — TracePass"
}
```

### 400 — Categoria o sottotipo non valido

```json
{ "error": "invalid_input", "field": "category", "message": "\"toaster\" is not a category with a passport template", "allowed": ["battery", "construction", "detergents", "electronics", "fmcg", "furniture", "jewelry", "packaging", "paints-coatings", "steel", "textile", "toys", "tyres"] }
```

### 401 — Non autorizzato

```json
{ "error": "Invalid or revoked API key" }
```

### 403 — Account non idoneo

```json
{ "error": "account_not_eligible", "reason": "email_not_verified" }
```

### 429 — Limite risposte superato

```json
{ "error": "scope_answer_cap", "limit": 100, "resetAt": "2026-10-12T00:00:00.000Z" }
```

### 503 — Dati normativi non disponibili

```json
{ "error": "regulatory_data_unavailable" }
```

## Related

- [POST Verificare l'ambito DPP](https://www.tracepass.eu/it/docs/check-scope.md)
- [GET Modifiche normative](https://www.tracepass.eu/it/docs/get-regulatory-changes.md)