Skip to main content
GET
List Packaging Units

Autorisierungen

Authorization
string
header
erforderlich

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

Abfrageparameter

internalRef
string

Return only the unit carrying exactly this reference (the upsert key of POST /api/ppwr/units). An empty value is not a filter that matches nothing — it is no filter at all.

limit
integer

Maximum number of rows to return. Opt-in: a request that sends neither limit nor offset returns the whole set. A non-numeric or non-positive value is a 400.

Erforderlicher Bereich: x >= 1
offset
integer

Number of rows to skip. Opt-in, same rules as limit; a non-numeric or negative value is a 400.

Erforderlicher Bereich: x >= 0

Antwort

List of packaging units

id
string<uuid>
erforderlich

The unit's id — what GET /api/ppwr/units/{id} and the PDF/export routes take.

name
string
erforderlich
internalRef
string
erforderlich

Your reference for the unit, or the PU-<n> the server generated for a row that sent none. This is the upsert key of POST /api/ppwr/units and the specInternalRef of the link endpoints.

packagingType
enum<string>
erforderlich
Verfügbare Optionen:
sales,
grouped,
transport,
ecommerce,
service
role
enum<string>
erforderlich

Your economic-operator role for this unit.

Verfügbare Optionen:
manufacturer,
importer,
distributor,
authorised_representative,
supplier,
fulfilment_service_provider
reusable
boolean
erforderlich

Art. 11 reusable packaging.

componentCount
integer
erforderlich

Number of components linked to the unit.

completeness
enum<string>
erforderlich

Data completeness of the unit, rolled up from its components: a unit is only as complete as its least complete component.

Verfügbare Optionen:
complete,
in_progress,
incomplete
missingFields
enum<string>[]
erforderlich

The required Annex VII fields still missing across the unit's components. Empty when complete.

Verfügbare Optionen:
heavyMetalsMgPerKg,
pfasCompliant
obligationStatus
enum<string>
erforderlich

Rollup of the unit's applicable PPWR obligations.

Verfügbare Optionen:
action_needed,
on_track,
upcoming
reuseStatus
enum<string>
erforderlich

State of the Art. 11 / Art. 26 re-use documentation for this unit.

Verfügbare Optionen:
missing,
incomplete,
documented,
pool_managed,
stale,
not_reusable,
not_applicable
recyclabilityGrade
enum<string> | null
Verfügbare Optionen:
A,
B,
C,
non_recyclable,
null