EU Digital Product Passport API and Resolver Architecture
Design the lookup path from data carrier to product passport without hard-coding an unsupported protocol choice.
This guide separates binding ESPR requirements from implementation choices for identifiers, resolvers, registries, access control, and interoperable data exchange.
Under the Ecodesign for Sustainable Products Regulation (ESPR), the passport is product-specific data made accessible through a data carrier and connected to persistent identifiers, access rights, registry records, and a Commission web portal. Architecture work should therefore start with the legal objects that must survive implementation choices: the product identifier, data carrier, passport data, registry upload, access-control model, or lookup path, and backup availability.
1
Section 1
Start with the binding ESPR architecture objects
The ESPR requires the applicable product-group delegated act to specify the passport data, one or more data carriers, the carrier layout and position, whether the passport is at model, batch, or item level, the pre-contract access method, and which actors can access, create, or update which data. Design the application programming interface (API) by recording which delegated-act fields, identifier granularity, access rights, and availability period the product group actually requires.
At the technical baseline, the passport must be connected through a data carrier to a persistent unique product identifier. The data carrier must be physically present on the product, packaging, or accompanying documentation as specified by the delegated act. Passport data must use open standards and interoperable formats and, as appropriate, be machine-readable, structured, and searchable; it must be transferable through an open interoperable data exchange network without vendor lock-in.
Treat model, batch, and item identity as an architecture decision, not a content-label decision.
Keep the data carrier, unique product identifier, operator identifiers, facility identifiers, and passport data model separately versioned.
Design public access, restricted access, update rights, and authority access as different authorization cases.
Do not store personal data relating to customers in the passport without their explicit consent in compliance with GDPR Article 6. Assess all other personal-data processing under the applicable data-protection rules.
Maintain the required backup-copy path through a DPP service provider.
Articles 9 to 11 define the DPP requirement, data carrier connection, persistent unique product identifier, open/interoperable data requirements, access-right controls, and backup-copy expectations.
persistent unique product identifier
2
Section 2
Separate the data carrier from the resolver
A data carrier is the physical or machine-readable entry point. It may encode or expose a unique product identifier, a web link, or another standards-based identifier form selected by the applicable rules and standards. The is the lookup component that turns the scanned or supplied identifier into the available passport links or data sources. Keeping those responsibilities separate makes it easier to change carriers, add a backup service, support batch lookup, or point different actors to different views without relabelling every product.
CIRPASS describes both web-address (HTTP URI) and decentralized identifier approaches as architectural options, not as a binding mandate. Its user stories show the same core pattern: scan or receive a product identifier, obtain a usable URI or endpoint, receive typed links for that identifier, select the relevant link, and request data from the data source with the credentials appropriate to the requester.
The carrier should be readable for the product context and durable enough for the expected product life.
The identifier should remain stable even when the passport data, hosting provider, or role-specific views change.
The should return enough typed links for public, authority, repair, recycling, and backup use cases without exposing restricted data by default.
The data source should enforce access rights; the should not become a shortcut around authorization.
The architecture should tolerate the responsible operator or a service provider changing infrastructure over time.
CIRPASS provides implementation-neutral resolver flows for HTTP URI and DID architectures, including data-carrier scanning, typed-link resolution, credentialed requests, and backup considerations.
ETSI explains the practical tradeoff between product-carrier storage and online passport access, including the need for URLs or links to remain accessible over the product's circular lifespan.
a URL that resolves into the required data
3
Section 3
Design registry and portal integration as separate channels
The live Commission Registry is not the public passport page or an operator's . It indexes DPPs through unique identifiers, registration data, and high-level metadata while the detailed passport remains decentralised. Implementing Regulation (EU) 2026/1778, effective from 6 August 2026, provides a secure user interface and API for registration, a verification platform, identity and authorisation controls, unique registration identifiers, a semantic repository, and logs.
The Commission web portal remains a separate search-and-compare layer constrained by product-specific access rights. Customs integration is another channel: for covered products, customs checks match the unique registration identifier and commodity code to Registry data. Automated Registry validation checks structure and completeness; market-surveillance authorities remain responsible for substantive correctness.
Keep the operator passport store or service provider store distinct from the Commission registry upload.
Store registry payload mappings for unique product identifiers, unique registration identifiers, and relevant commodity codes.
Treat the Commission portal as a search and comparison surface, not as the only passport hosting model.
Build evidence that registry data stays current when product identifiers, commodity codes, or passport hosting details change.
Do not describe a registry acknowledgement as legal compliance approval.
Articles 13 to 15 define the Commission registry, public web portal, unique registration identifier, customs verification, commodity-code linkage, and EU CSW-CERTEX interconnection.
Current binding source for the Registry interface and API, verification platform, user identification and authorisation, registration identifiers, semantic repository, logging, versioning, customs data, and the limit of automated validation.
Current operational source for organisation enrolment, testing, registration and management, and the decentralised relationship between the Registry and detailed passport data.
4
Section 4
Make access control part of the data model, not only the API gateway
The ESPR requires free and easy access based on actor-specific rights, and it restricts rights to introduce, modify, or update passport data according to access rights specified in delegated acts. A useful architecture therefore marks each passport data element with audience, source, owner, update authority, verification status, and public or restricted presentation rules before it is exposed through any API.
flows should support anonymous public access for general passport information and credentialed access for actors such as authorities, recyclers, repairers, refurbishers, remanufacturers, and other relevant parties. CIRPASS examples describe credentialed requests for more refined data and update endpoints, while ESPR leaves the exact digital credential procedures to implementing acts. Avoid claiming that one token format, identity framework, or API style is legally required unless the relevant EU act or harmonised standard says so.
Create a field-level access matrix for public users, economic operators, marketplaces, repairers, recyclers, market surveillance authorities, customs authorities, and service providers.
Separate read rights from introduce, modify, update, and withdraw rights.
Record which actor supplied each data element and which actor can correct it.
Expose public data without forcing a vendor-specific app where the carrier and link pattern can support ordinary web access.
Use credentials for restricted or update operations, but keep the credential mechanism replaceable until EU procedures and product-group rules are fixed.
CIRPASS role-based flows distinguish default public access from credentialed access for actors needing more refined DPP data or update capabilities.
credentials must be provided
5
Section 5
Avoid premature protocol and API mandates
The binding baseline is that the DPP must be interoperable, standards-based, and transferable without vendor lock-in and, as appropriate, machine-readable, structured, and searchable. Commission Implementing Decision (EU) 2026/1736, in force from 15 July 2026, cites EN 18216:2026 for data exchange protocols, EN 18219:2026 for unique identifiers, EN 18220:2026 for data carriers, EN 18221:2026 for storage, archiving and persistence, EN 18222:2026 for lifecycle-management and search APIs, and EN 18223:2026 for system interoperability.
A DPP that conforms to a cited standard is presumed to conform only with the ESPR Articles 10 and 11 requirements that standard covers. The decision does not make REST, GraphQL, a specific decentralised identifier method, a specific barcode syntax, or one pattern universal. Check the standard's scope, the applicable product rule, and any implementing act before describing a technical choice as required.
For engineering work, define replaceable interfaces: carrier decoding, identifier normalization, lookup, typed-link selection, data-source retrieval, credential verification, field-level filtering, registry upload, portal/search feed, and audit logging. This lets a team test architecture assumptions now while preserving the ability to swap standards or sector choices later.
Document protocol choices as implementation decisions, not as EU legal mandates.
Keep an identifier abstraction so HTTP URI and other standards-based schemes can be supported where appropriate.
Use open data formats and semantic mappings so product-group data can interoperate across sectors and actors.
Plan batch lookup for professional buyers, authorities, and internal product reviews that receive lists of product identifiers.
Test failure modes such as stale links, 404 responses, operator insolvency, domain transfer, and backup-provider activation.
ESPR sets open, interoperable, transferable, and vendor-lock-in requirements, with machine-readable, structured, and searchable data required as appropriate, without naming a universal API protocol for all passports.
CIRPASS validates both HTTP URI and DID architecture options and highlights unresolved backup/archive details, supporting a replaceable rather than hard-coded resolver design.
Current Commission source for published references to harmonised DPP standards; use the cited standard and its scope before treating a protocol or carrier choice as legally supported.
Binding source for the names and editions of the six cited harmonised DPP standards and their presumption-of-conformity effect for the ESPR Articles 10 and 11 requirements they cover.
6
Section 6
Architecture evidence to keep before launch
A DPP architecture review should produce evidence that a visitor, authority, customs user, or downstream circular-economy actor can follow from the physical product to the right passport data. The evidence should show the carrier value, identifier level, response, source links, role-based filtering, registry upload state, and backup behavior for representative products.
The evidence file should also record open points. If a product group's delegated act has not yet specified exact carrier layout, data fields, access rights, or passport level, state that as an implementation dependency rather than filling the gap with unsupported dates, thresholds, or protocol requirements.
The review should explicitly validate the update and recovery scenarios that visitors would expect to see in the full architecture: repairer updates, independent refurbisher handover, recycler reporting, remanufacturer replacement of the original passport, and fallback to a backup or archive after operator insolvency.
Data carrier sample, scan result, and decoded identifier for each product label or documentation placement.
Identifier register showing product, operator, facility, and any registry registration identifiers with version history.
test output showing typed links, public response, restricted response, and fallback behavior.
Access-right matrix mapped to each passport data field and actor class.
Registry and customs data mapping for unique registration identifier and commodity code where applicable.
Backup and persistence plan covering service-provider continuity, domain or endpoint changes, and expected product lifetime.
Validation notes for repair, refurbishment, remanufacturing, recycling, and market-authority access paths.
ETSI identifies persistence, authenticity, integrity, verifiability, traceability, and accessible online information as important properties for DPP information over a circular product lifespan.
traceability of products
Recommended next step
Review your DPP lookup architecture
Map carriers, identifiers, resolver responses, access rights, registry fields, and backup behavior before committing to a protocol or vendor implementation.
Primary legal source for DPP requirements, including data carriers, persistent unique product identifiers, access rights, registry, web portal, customs controls, and interoperability requirements.
Articles 9 to 11 define the DPP requirement, data carrier connection, persistent unique product identifier, open/interoperable data requirements, access-right controls, and backup-copy expectations.
Articles 13 to 15 define the Commission registry, public web portal, unique registration identifier, customs verification, commodity-code linkage, and EU CSW-CERTEX interconnection.
Show 3 more
Article 11 requires actor-specific access rights, restricted update rights, data authentication, integrity, security, privacy, and fraud avoidance.
ESPR sets open, interoperable, transferable, and vendor-lock-in requirements, with machine-readable, structured, and searchable data required as appropriate, without naming a universal API protocol for all passports.
ESPR requires accurate, complete, up to date passport data, persistent identifiers, specified access periods, backup copies, registry upload, and authority/customs access.
Technical architecture source for resolver concepts, product-identifier-centred flows, HTTP URI and DID options, typed links, credentialed role-based access, and backup/archive considerations.
CIRPASS provides implementation-neutral resolver flows for HTTP URI and DID architectures, including data-carrier scanning, typed-link resolution, credentialed requests, and backup considerations.
CIRPASS role-based flows distinguish default public access from credentialed access for actors needing more refined DPP data or update capabilities.
Show 2 more
CIRPASS validates both HTTP URI and DID architecture options and highlights unresolved backup/archive details, supporting a replaceable rather than hard-coded resolver design.
CIRPASS identifies the need for validation of HTTP URI and DID architectures, plus backup and archive handling for out-of-business scenarios.
Standards-oriented source for DPP information quality properties, product identifiers, data carrier versus online access tradeoffs, lifecycle updates, lookup services, and persistence needs.
ETSI explains the practical tradeoff between product-carrier storage and online passport access, including the need for URLs or links to remain accessible over the product's circular lifespan.
ETSI identifies persistence, authenticity, integrity, verifiability, traceability, and accessible online information as important properties for DPP information over a circular product lifespan.
Official Journal decision citing the six EN 182xx:2026 standards for data exchange, identifiers, carriers, persistence, APIs, and interoperability.
Binding source for the names and editions of the six cited harmonised DPP standards and their presumption-of-conformity effect for the ESPR Articles 10 and 11 requirements they cover.
Binding Registry architecture source, effective from 6 August 2026, including the registration API and semantic repository.
Current binding source for the Registry interface and API, verification platform, user identification and authorisation, registration identifiers, semantic repository, logging, versioning, customs data, and the limit of automated validation.
Official reference page for harmonised DPP standards.
Current Commission source for published references to harmonised DPP standards; use the cited standard and its scope before treating a protocol or carrier choice as legally supported.
Current operational source for organisation enrolment, testing, registration and management, and the decentralised relationship between the Registry and detailed passport data.