---
title: Kategorie-Vorlage lesen
description: Das vollständige regulatorische Schema einer DPP-Kategorie lesen — jedes Feld mit Schlüssel, Typ, Pflicht-Flag, Zugriffsebene und Verordnungsreferenz.
canonical: "https://www.tracepass.eu/de/docs/get-template"
locale: de
source: "https://www.tracepass.eu/de/docs/get-template"
---

# Kategorie-Vorlage lesen

> Das vollständige regulatorische Schema einer DPP-Kategorie lesen — jedes Feld mit Schlüssel, Typ, Pflicht-Flag, Zugriffsebene und Verordnungsreferenz.

```http
GET /api/v1/templates/{category}
```

Liefert das vollständige regulatorische Feldschema einer DPP-Kategorie — jedes Feld mit Schlüssel, englischem Label, Datentyp, Pflicht-Flag, Zugriffsebene, Validierungsgrenzen, Enum-Optionen (sofern zutreffend) und dem maßgeblichen Verordnungsartikel/-anhang (`regulationRef`). Dies ist die Abfrage hinter konformitätsbewussten Integrationen und dem Compliance-Copilot des MCP-Servers.

Die Projektion ist schlank für API-/KI-Consumer: interne KI-Hinweise, mehrsprachige Platzhalterkarten und Sortier-Buchhaltung pro Feld entfallen, die regulatorische Substanz bleibt. Labels kommen in kanonischem Englisch; die vollständigen lokalisierten Label-Karten bleiben in der Dashboard-Template-API.

`{category}` ist einer der 12 Kategorieschlüssel (battery, textile, electronics, construction, steel, chemicals, packaging, furniture, tyres, jewelry, toys, fmcg). Eine unbekannte Kategorie liefert 404 mit dem Code `TEMPLATE_NOT_FOUND` — gültige Schlüssel listet `GET /api/v1/templates`.

## 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` | path | string | yes | Einer der 12 Kategorieschlüssel, z. B. `battery`, `textile`, `electronics`. |

## Examples

```bash
curl -sS https://app.tracepass.eu/api/v1/templates/battery \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"
```

```typescript
const res = await fetch(
  "https://app.tracepass.eu/api/v1/templates/battery",
  { headers: { Authorization: `Bearer ${process.env.TRACEPASS_API_KEY}` } },
);
if (res.status === 404) throw new Error("Unknown category");
const template = await res.json();
```

```python
import os, requests
res = requests.get(
    "https://app.tracepass.eu/api/v1/templates/battery",
    headers={"Authorization": f"Bearer {os.environ['TRACEPASS_API_KEY']}"},
)
res.raise_for_status()
template = res.json()
```

## Responses

### 200 — Erfolg

```json
{
  "category": "battery",
  "categoryLabel": "Battery",
  "version": 3,
  "regulation": "EU Battery Regulation 2023/1542",
  "fieldCount": 93,
  "requiredFieldCount": 64,
  "fields": [
    {
      "key": "battery_chemistry",
      "label": "Battery chemistry",
      "dataType": "enum",
      "required": true,
      "accessLevel": "public",
      "category": "Battery characteristics",
      "enumOptions": [
        { "value": "lithium-ion", "label": "Lithium-ion" },
        { "value": "lead-acid", "label": "Lead-acid" }
      ],
      "validation": {},
      "regulationRef": "Annex VI, Part A"
    }
  ]
}
```

### 404 — Unbekannte Kategorie

```json
{
  "error": "No template for category \"widgets\". Use GET /api/v1/templates to list valid categories.",
  "code": "TEMPLATE_NOT_FOUND"
}
```

## Related

- [Kategorie-Vorlagen auflisten](https://www.tracepass.eu/de/docs/list-templates.md)
- [Pass-Feld aktualisieren](https://www.tracepass.eu/de/docs/update-field.md)