---
title: Pflichtfelder abrufen
description: DPP-Pflichtfelder für eine Produktkategorie — Artikelzitate, Zugangsstufen, voraussichtliche Felder und (Batterien) Hersteller- oder Lieferanten-Flags.
canonical: "https://www.tracepass.eu/de/docs/get-required-fields"
locale: de
source: "https://www.tracepass.eu/de/docs/get-required-fields"
---

# Pflichtfelder abrufen

> DPP-Pflichtfelder für eine Produktkategorie — Artikelzitate, Zugangsstufen, voraussichtliche Felder und (Batterien) Hersteller- oder Lieferanten-Flags.

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

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.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Authorization` | header | string | yes | `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. |
| `category` | query | string | yes | Vorlagen-Kategorieschlüssel — z. B. `battery`, `detergents`, `toys`. Liefert 400 `invalid_input` mit der `allowed`-Liste bei unbekanntem Schlüssel. |
| `group` | query | string | no | Vorlagen-Gruppenschlüssel (das Feld `category` auf jedem Vorlagenfeld). Bei Fehlen: Zusammenfassung; bei Angabe: vollständige Feldliste der Gruppe. |
| `subType` | query | string | no | Batterie-Untertyp — `EV`, `LMT` oder `industrial_gt_2kwh`. Filtert `requiredBy` wie die Compliance-Engine. Liefert 400 bei unbekanntem Untertyp. |
| `locale` | query | string | no | Antwortsprache für den `answer`-Text — `en`, `bg`, `de` oder `it`. Standard: `Accept-Language`-Header, dann `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 — Pflichtfelder-Zusammenfassung

```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 — Ungültige Kategorie oder Untertyp

```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 — Nicht autorisiert

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

### 403 — Konto nicht berechtigt

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

### 429 — Antwortlimit überschritten

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

### 503 — Regulatorische Daten nicht verfügbar

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

## Related

- [POST DPP-Anwendungsbereich prüfen](https://www.tracepass.eu/de/docs/check-scope.md)
- [GET Regulatorische Änderungen](https://www.tracepass.eu/de/docs/get-regulatory-changes.md)