/api/v1/regulatory/required-fieldsPflichtfelder abrufen
Gibt die erforderlichen und voraussichtlichen Felder für einen Pass der angegebenen Kategorie zurück, mit dem EU-Regulierungsartikel, auf dem jedes Feld beruht, seiner Zugangsstufe (public / restricted / authority) und — für Batterien — ob die Daten üblicherweise vom Hersteller, einem Lieferanten oder dem Betreiber gehalten werden. Ohne `group` gibt der Endpoint eine Zusammenfassung zurück: Gesamtzahlen nach Gruppe und Zugangsstufe, plus `requiredByHolder` (nur Batterien). Mit `group` — die vollständige Feldliste für diese Gruppe.
Verfügbar in jedem Tarif. Zählt eine Scope-Antwort auf das unternehmensweite Limit (~100/Tag, ~30/Minute, kanalübergreifend). Unbekannte `category` liefert 400 `invalid_input` mit der `allowed`-Liste. Ein ungültiger `subType` liefert ebenfalls 400.
Fügen Sie `X-Source: assistant` hinzu, wenn Sie im Auftrag des DPP-Assistenten-MCP-Servers aufrufen — die Antwort wird dann vom Assistenten signiert und das OAuth-Konto-Gate gilt (verifizierte, nicht-wegwerfbare E-Mail erforderlich). API-Schlüssel umgehen das Gate.
Query-Parameter
- categoryerforderlich
string
Vorlagen-Kategorieschlüssel — z. B. `battery`, `detergents`, `toys`. Liefert 400 `invalid_input` mit der `allowed`-Liste bei unbekanntem Schlüssel.
e.g. detergents
- group
string
Vorlagen-Gruppenschlüssel (das Feld `category` auf jedem Vorlagenfeld). Bei Fehlen: Zusammenfassung; bei Angabe: vollständige Feldliste der Gruppe.
e.g. general_info
- subType
string
Batterie-Untertyp — `EV`, `LMT` oder `industrial_gt_2kwh`. Filtert `requiredBy` wie die Compliance-Engine. Liefert 400 bei unbekanntem Untertyp.
e.g. industrial_gt_2kwh
- locale
string
Antwortsprache für den `answer`-Text — `en`, `bg`, `de` oder `it`. Standard: `Accept-Language`-Header, dann `en`.
e.g. en
Header
- Authorizationerforderlich
string
`Bearer <token>` — entweder ein `tp_` API-Schlüssel (Developer → API Keys; am einfachsten, für Server-zu-Server) oder ein OAuth-2.0-Access-Token (Developer → OAuth Apps; für nutzerautorisierte Apps, scoped und widerrufbar). Die Authentication-Seite enthält den vollständigen OAuth-Flow und die Scope-Liste.
e.g. Bearer tp_REDACTED_xxxxxxxxxxxx
Anfrage
curl -sS "https://app.tracepass.eu/api/v1/regulatory/required-fields?category=detergents&locale=en" \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"Antwort
{
"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"
}