TracePass
Inizia ora
Assistente normativo

Ottieni campi obbligatori

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.

GET/api/v1/regulatory/required-fields
Scarica OpenAPI 3.1
GET/api/v1/regulatory/required-fields

Ottieni campi obbligatori

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.

Parametri di query

  • categoryobbligatorio

    string

    Chiave categoria template — es. `battery`, `detergents`, `toys`. Restituisce 400 `invalid_input` con la lista `allowed` se non riconosciuto.

    e.g. detergents

  • group

    string

    Chiave gruppo template (campo `category` su ogni campo template). Se assente restituisce un riepilogo; se presente, l'elenco completo dei campi del gruppo.

    e.g. general_info

  • subType

    string

    Sottotipo batteria — `EV`, `LMT` o `industrial_gt_2kwh`. Filtra `requiredBy` come il motore di conformità. Restituisce 400 per sottotipo non riconosciuto.

    e.g. industrial_gt_2kwh

  • locale

    string

    Lingua risposta per il testo `answer` — `en`, `bg`, `de` o `it`. Predefinito: header `Accept-Language`, poi `en`.

    e.g. en

Header

  • Authorizationobbligatorio

    string

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

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Richiesta

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

Risposta

{
  "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"
}

Endpoint correlati