Regulatory

How to register and which identifiers/data carriers to use.

Returns guidance on DPP registry registration, identifier schemes (GTIN, serial, GS1 Digital Link), data carrier requirements (QR code, NFC, RFID), and where a passport is actually created for a given topic.

Auth: Bearer API key OR OAuth with regulatory:read OR passports:read. Counts as one scope answer.

get/api/v1/regulatory/registry-guidance

Request

  • Base URL: https://app.tracepass.eu
  • URL: https://app.tracepass.eu/api/v1/regulatory/registry-guidance
  • 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

topic'registration' | 'identifiers' | 'data_carriers' | 'qr_code' | 'nfc_rfid' | 'gs1_digital_link' | 'access_rights' required

The guidance topic to retrieve. One of: registration, identifiers, data_carriers, qr_code, nfc_rfid, gs1_digital_link, access_rights.

categorystring

Optional product category to tailor the guidance (e.g. battery returns battery-specific registry requirements alongside the general guidance).

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

Language for the guidance text.

Headers

Authorizationstring required

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

Response

Registry guidance for the requested topic.

topicstring required

The topic as requested.

guidancestring required

Plain-language guidance text in the requested locale, including relevant article and annex references.

ruleIdsstring[] required

Changes

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