Regulatory

Required DPP fields for a category with EU article citations.

Returns the mandatory fields for a DPP product category, each annotated with the EU regulation article that requires it and — for battery passports — the role that holds the field (manufacturer / importer / distributor).

Auth: Bearer API key OR OAuth with regulatory:read OR passports:read. Counts as one scope answer against the daily cap when called via the assistant channel (X-Source: assistant).

Account gate (OAuth + X-Source: assistant only): the requesting user's email must be verified and not from a disposable domain. API-key callers bypass this gate.

get/api/v1/regulatory/required-fields

Request

  • Base URL: https://app.tracepass.eu
  • URL: https://app.tracepass.eu/api/v1/regulatory/required-fields
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.tracepass.eu/api/oauth/authorize, token URL https://app.tracepass.eu/api/oauth/token, scopes: regulatory:read)
    • OAuth 2 (authorization code, authorization URL https://app.tracepass.eu/api/oauth/authorize, token URL https://app.tracepass.eu/api/oauth/token, scopes: passports:read)

Query parameters

categorystring required

Template category key (e.g. battery, textile, electronics). Must be a key returned by GET /api/v1/templates.

groupstring

Optional sub-group filter (e.g. PortableIndustrialBattery). When omitted, all groups for the category are returned.

subTypestring

Optional sub-type filter within a group (e.g. LFP). When omitted, all sub-types are returned.

locale'en' | 'bg' | 'de' | 'it'

Language for field labels and article descriptions.

Headers

Authorizationstring required

Bearer <api-key> or Bearer <access-token>.

Response

Required fields with EU citations.

categorystring required

The requested category key.

fieldCountinteger required

Total number of required fields returned.

ruleIdsstring[] required

Rule identifiers backing this answer — pass back to POST /api/v1/scope/reports to route a correction.

Changes

No recorded changes to this operation across all 1 revision of this API.