TracePass
Get started
Regulatory assistant

Get required fields

Returns the required and anticipated fields for a passport of the given category, with the EU regulation article each field rests on, its access tier (public / restricted / authority), and — for batteries — whether the data is usually held by the maker, a supplier, or the operator. Without `group`, the endpoint returns a summary: total counts broken down per group and per access tier, plus `requiredByHolder` (battery only) grouping required fields by data source. With `group`, it returns the full field list for that group.

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

Get required fields

Returns the required and anticipated fields for a passport of the given category, with the EU regulation article each field rests on, its access tier (public / restricted / authority), and — for batteries — whether the data is usually held by the maker, a supplier, or the operator. Without `group`, the endpoint returns a summary: total counts broken down per group and per access tier, plus `requiredByHolder` (battery only) grouping required fields by data source. With `group`, it returns the full field list for that group.

Available on every plan. Counts one scope answer against the per-company answer cap (~100 answers per day, ~30 per minute, shared across the dashboard, API, and the DPP Assistant). At the cap the endpoint returns 429 `scope_answer_cap`. An unknown `category` returns 400 `invalid_input` with the `allowed` list of template categories. An invalid `subType` for the given category also returns 400. For batteries, `subType` filters `requiredBy` the same way the compliance engine does.

Add `X-Source: assistant` when calling on behalf of the DPP Assistant MCP server — the answer is then signed by the assistant and the OAuth account gate applies (verified, non-disposable email required). API keys bypass the account gate.

Query parameters

  • categoryrequired

    string

    Template category key — e.g. `battery`, `detergents`, `toys`. Returns 400 `invalid_input` with the `allowed` list when not recognised.

    e.g. detergents

  • group

    string

    Template group key (the `category` field on each template field). When absent, returns a summary; when present, returns the full field list for that group.

    e.g. general_info

  • subType

    string

    Battery sub-type — `EV`, `LMT`, or `industrial_gt_2kwh`. Filters `requiredBy` the same way the compliance engine does. Returns 400 when the category has no sub-types or the value is not recognised.

    e.g. industrial_gt_2kwh

  • locale

    string

    Response language for the `answer` text — `en`, `bg`, `de`, or `it`. Defaults to the `Accept-Language` header, then `en`.

    e.g. en

Headers

  • Authorizationrequired

    string

    `Bearer <token>` — either a `tp_` API key (Developer → API Keys; simplest, for server-to-server) or an OAuth 2.0 access token (Developer → OAuth Apps; for user-authorized apps, scoped + revocable). The Authentication page has the full OAuth flow and scope list.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Request

curl -sS "https://app.tracepass.eu/api/v1/regulatory/required-fields?category=detergents&locale=en" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Response

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

Related endpoints