Skip to main content
GET
List Declarations of Conformity

Authorizations

Authorization
string
header
required

API key generated in Settings > API Keys. Include as Authorization: Bearer <key>.

Query Parameters

specId
string<uuid>

Only declarations covering this packaging unit (any version — the unit's DoC history).

status
enum<string>
Available options:
draft,
issued,
superseded,
withdrawn
origin
enum<string>
Available options:
generated,
collected
changedSince
string<date-time>

Only declarations that changed at or after this instant (inclusive): issued, withdrawn, verified, collected file lost, superseded, or activeSpecIds shrank because a newer declaration took over one of its units — the replaced declaration and its successor both match. ISO 8601 with Z or an offset. Drafts carry no timestamp and never match.

limit
integer
default:100

Maximum number of results to return (default 100, max 1000).

Required range: 1 <= x <= 1000
offset
integer | null
default:0

Number of results to skip for pagination.

Required range: x >= 0
fields
string

Comma-separated list of the resource's top-level keys to return (per element for a list), e.g. id,name; omit for the full body. Top-level only; whitespace is trimmed and duplicates count once. fields never adds keys: a selected optional key that is absent on a row stays absent. 400 when passed more than once, when empty, or when it names an unknown key (the error names it and lists the allowed ones).

Response

List of declarations

id
string
required

UUID of the declaration — what GET /api/v1/ppwr/declarations/{id} takes.

version
number
required

Version number; a successor that supersedes this declaration carries a higher one.

status
string
required

Status of the declaration: draft, issued, superseded or withdrawn. One of: draft, issued, superseded, withdrawn.

origin
string
required

generated (drawn up in the app) or collected (the manufacturer's uploaded DoC). One of: generated, collected.

referenceNumber
string | null
required

Reference number printed on the declaration, or null (e.g. for a draft).

issuedAt
string | null
required

When the declaration was issued (ISO 8601, UTC); null for a draft.

withdrawnAt
string | null
required

When the declaration was withdrawn (ISO 8601, UTC); null unless withdrawn.

supersededAt
string | null
required

When a newer declaration replaced this one for its last unit (ISO 8601, UTC); null unless status is superseded, and can also be null for a declaration superseded before 2026-10 whose successors were since deleted. A family declaration that loses only some units to a newer one stays issued with supersededAt: null — those units leave its activeSpecIds.

supersedesId
string | null
required

UUID of the earlier declaration this one replaces, or null.

verified
boolean
required

A generated DoC always; a collected DoC once its verification passed and while its file is on record.

isFallback
boolean
required

An importer substitute DoC (Ersatz-Konformitätserklärung).

pdfUrl
string | null
required

Path of the PDF download (GET, same API key); null for a draft, and for a collected declaration whose uploaded file is no longer on record (the download would answer 404) — verified is then false too.

specIds
string[]
required

Every packaging unit the declaration covers (a family DoC covers several).

activeSpecIds
string[]
required

The units it is currently the active DoC for.