Skip to main content
GET
List Packaging Components

Authorizations

Authorization
string
header
required

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

Query Parameters

code
string

Return the components carrying exactly this code. This narrows to a set, not to a row: a code is unique per supplier bucket, so the same code may exist once in your own catalogue and once under a supplier who replied with it. Combine with supplierId to pick one. An empty value is no filter.

supplierId
string

Narrow to the components of one supplier: a supplier UUID, or the literal none for your own (customer-authored) bucket. A value that is neither matches nothing rather than widening the result.

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.

Required range: x >= 1
offset
integer

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

Required range: x >= 0

Response

List of packaging components

id
string<uuid>
required
companyId
string<uuid>
required
code
string
required

Your component code — half of the upsert key of POST /api/ppwr/components (the other half is the resolved supplier).

name
string
required
materials
enum<string>[]
required
Available options:
plastic,
paper_board,
glass,
metal,
wood,
composite,
other
contactSensitive
boolean
required
foodContact
boolean
required
heavyMetalsValueKind
enum<string>
required

Whether the heavy-metals value is a measurement or a declared bound.

Available options:
measured,
declared_within_limit
heavyMetalsRecycledGlassDerogation
boolean
required

The recycled-glass attestation for the Art. 5(4) sum. Set in the app only; no import or API write touches it.

pfasTotalFluorineValueKind
enum<string>
required
Available options:
measured,
declared_within_limit
pfasSumValueKind
enum<string>
required
Available options:
measured,
declared_within_limit
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
createdByUserId
string<uuid> | null
updatedByUserId
string<uuid> | null

The last human editor; null when no human write path has stamped it.

supplierId
string<uuid> | null

null for a component of your own catalogue.

polymer
enum<string> | null
Available options:
pet,
hdpe,
ldpe,
pp,
ps,
pvc,
other,
null
massGrams
string | null

Mass of one piece, in grams.

recycledContentPct
string | null
recycledContentSource
enum<string> | null
Available options:
pcr,
pir,
null
recycledContentMethod
enum<string> | null
Available options:
physical,
mass_balance,
null
heavyMetalsMgPerKg
string | null
heavyMetalsBasis
enum<string> | null
Available options:
test_report,
supplier_declaration,
not_substantiated,
null
heavyMetalsMethod
string | null
heavyMetalsEvidenceId
string<uuid> | null

The evidence document backing the heavy-metals value, when one is attached.

pfasCompliant
boolean | null

Tri-state: null = unknown.

pfasBasis
enum<string> | null
Available options:
test_report,
supplier_declaration,
not_substantiated,
null
pfasMethod
string | null
pfasTotalFluorineMgPerKg
string | null
pfasSumPpb
string | null
pfasEvidenceId
string<uuid> | null
lastProvidedBySupplierId
string<uuid> | null

The supplier who last supplied this component's data through a data request.

lastProvidedAt
string<date-time> | null
notes
string | null
deletedAt
string<date-time> | null

Always null here — these routes never return a soft-deleted component.

retentionUntil
string<date-time> | null

Set only on a deleted component, so always null here.