TracePass
Regulatorischer Assistent

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

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

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