/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 400invalid_inputmit derallowed-Liste bei unbekanntem Schlüssel.e.g. detergents
- group
string
Vorlagen-Gruppenschlüssel (das Feld
categoryauf jedem Vorlagenfeld). Bei Fehlen: Zusammenfassung; bei Angabe: vollständige Feldliste der Gruppe.e.g. general_info
- subType
string
Batterie-Untertyp —
EV,LMToderindustrial_gt_2kwh. FiltertrequiredBywie die Compliance-Engine. Liefert 400 bei unbekanntem Untertyp.e.g. industrial_gt_2kwh
- locale
string
Antwortsprache für den
answer-Text —en,bg,deoderit. Standard:Accept-Language-Header, dannen.e.g. en
Header
- Authorizationerforderlich
string
Bearer <token>— entweder eintp_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"
}