Skip to content

Traceability

cdse.traceability

The Traceability API.

The traceability service records a signed trace for every product, which lets you confirm a product's origin and integrity. The service is publicly readable, so this client does not send a bearer token.

Only the lookup by product name is documented; other endpoints are described in the service's OpenAPI page. The trace record schema is not published, so the :class:Trace model keeps every returned field. Verifying the digital signature of a trace involves certificate handling and is delegated to the official trace-cli tool (https://github.com/eu-cdse/trace-cli).

Trace

Bases: BaseModel

A traceability record for a product.

Because the response schema is not published, unknown fields are retained and can be read with :meth:pydantic.BaseModel.model_dump. The few fields declared here are best effort and may be absent.

TraceabilityResource

TraceabilityResource(http: Client, base_url: str)

Look up product traceability records.

This resource uses a plain HTTP client because the service is public.

get_by_name

get_by_name(product_name: str) -> Trace

Fetch the trace for a product by its name.

get

get(endpoint: str) -> Any

Call an arbitrary traceability endpoint and return parsed JSON.

This is an escape hatch for endpoints not modelled here. endpoint is appended to the base URL.