Open, unauthenticated endpoints for reading Digital Product Passports, resolving GS1 Digital Links, verifying supply chain data, and accessing EU compliance trust documents. No API key required.
Cryptographic identity documents for PassportLab. These endpoints are used by verifiers, wallets, and DID resolvers to retrieve the public signing key and conformance manifest.
GET/.well-known/did.jsonW3C DID:Web • UNTP v0.7.0
Returns the PassportLab DID:Web document containing the organisation's Ed25519 public key. Used by third-party verifiers to check digital signatures on W3C Verifiable Credentials and SD-JWTs without contacting PassportLab at verification time.
Request · Response
Request
GET /.well-known/did.json HTTP/1.1
Host: api.passportlab.io
Accept: application/json
UNTP (UN Transparency Protocol) conformance manifest. Declares PassportLab's conformance with the UN Transparency Protocol v0.7.0 and lists the credential types issued (DigitalProductPassport, DigitalConformityCredential, DigitalTraceabilityEvent, DigitalFacilityRecord).
Request · Response
Request
GET /.well-known/untp-conformance.json HTTP/1.1
Host: api.passportlab.io
Resolves GS1-standard product identifiers (GTIN + serial number) to the corresponding Digital Product Passport. Compatible with any GS1-compliant scanner or resolver network. Supports Accept: application/linkset+json for GS1 link-set responses.
GET/api/v1/public/01/{gtin}/21/{serial}GS1 Digital Link 1.1 • ISO/IEC 15418
Resolves a GS1 Digital Link (GTIN + serial) to the associated DPP. Returns a redirect to the DPP public URL, or a JSON/linkset response depending on the Accept header. This is the URL embedded in QR codes printed on physical products.
Parameters
Name
In
Type
Description
gtin
path
string
GS1 GTIN-14 (14-digit global trade item number)
serial
path
string
GS1 Serial Number (AI 21)
Headers
Name
Required
Description
Accept
No
Set to application/linkset+json to receive a GS1 link-set document instead of a redirect
Request · Response
Request
GET /api/v1/public/01/09506000134352/21/SN-2024-001 HTTP/1.1
Host: api.passportlab.io
Accept: application/json
Lists all active Digital Product Passports registered under a GTIN. Useful when the serial number is not available (e.g. from a product class barcode). Falls back to the GS1 global resolver at id.gs1.org if no DPPs are registered for this GTIN.
Parameters
Name
In
Type
Description
gtin
path
string
GS1 GTIN-14
Request · Response
Request
GET /api/v1/public/01/09506000134352 HTTP/1.1
Host: api.passportlab.io
Read the full content of a Digital Product Passport and retrieve its QR code. These endpoints are used by consumer apps, retailer systems, recyclers, and customs authorities to access product sustainability data.
GET/api/v1/public/dpp/{dpp_code}ESPR 2024/1781 • EU Battery Reg. 2023/1542
Returns the full public data of a Digital Product Passport. Includes product identity, materials, carbon footprint, repairability score, certifications, and all ESPR-mandated fields. The response language adapts to the Accept-Language header, using whichever ISO 639-1 translations the manufacturer supplied. Role-based field visibility applies when an X-Stakeholder-Key header is present.
Parameters
Name
In
Type
Description
dpp_code
path
string
DPP identifier (e.g. DPP-09506000134352-SN-001 or a UUID-based code)
Headers
Name
Required
Description
Accept-Language
No
ISO 639-1 language code. Returns translated field labels for any language the manufacturer supplied a translation for (not limited to a fixed set).
X-Stakeholder-Key
No
Stakeholder API key for role-filtered views (consumer, retailer, customs, msa, notified_body).
Request · Response
Request
GET /api/v1/public/dpp/DPP-09506000134352-SN-001 HTTP/1.1
Host: api.passportlab.io
Accept-Language: de
Returns the raw W3C Verifiable Credential JSON (Content-Type: application/vc+ld+json). The proof is an eddsa-jcs-2022 DataIntegrityProof; the verificationMethod points to did:web:passportlab.io#key-1. Resolve /.well-known/did.json to get the Ed25519 public key and verify offline.
Parameters
Name
In
Type
Description
dpp_code
path
string
DPP identifier
Request · Response
Request
GET /api/v1/public/dpp/DPP-09506000134352-SN-001/vc HTTP/1.1
Host: api.passportlab.io
Accept: application/vc+ld+json
Returns the DPP credential as a compact JWS (vc+jwt). The JWT header contains alg=EdDSA and kid=did:web:passportlab.io#key-1. Decode the header, resolve the DID document, get the publicKeyJwk for that kid, and verify the Ed25519 signature. Compatible with any standard JWT library that supports OKP keys.
Parameters
Name
In
Type
Description
dpp_code
path
string
DPP identifier
Request · Response
Request
GET /api/v1/public/dpp/DPP-09506000134352-SN-001/vc.jwt HTTP/1.1
Host: api.passportlab.io
GET/api/v1/public/dpp/{dpp_code}/qr.pngGS1 Digital Link 1.1
Returns a PNG QR code image encoding the GS1 Digital Link URL for this product. Print it on packaging, labels, or product inserts. Scanning the QR code takes the end consumer to the public DPP view at passportlab.io/dpp/{code}.
Parameters
Name
In
Type
Description
dpp_code
path
string
DPP identifier
size
query
integer
Image size in pixels (default: 300). Range: 100–2000.
Request · Response
Request
GET /api/v1/public/dpp/DPP-09506000134352-SN-001/qr.png?size=400 HTTP/1.1
Host: api.passportlab.io
Response 200 OK
HTTP/1.1 200 OK
Content-Type: image/png
Content-Length: 3214
<binary PNG data>
4. Verification
Verify the cryptographic integrity of a Digital Product Passport. These endpoints validate Ed25519 signatures, check W3C VC proof chains, and verify SD-JWT selective disclosure tokens issued by PassportLab.
Verifies the cryptographic proof on a DPP and returns the verification result. Checks that the Ed25519 signature is valid against the PassportLab DID:Web public key. Returns the signing key, issuer DID, and whether the proof passes.
Parameters
Name
In
Type
Description
dpp_code
path
string
DPP identifier
Request · Response
Request
GET /api/v1/verify/DPP-09506000134352-SN-001 HTTP/1.1
Host: api.passportlab.io
Verifies a raw W3C Verifiable Credential JSON-LD document. Submit any VC issued by PassportLab to check the proof. Returns validation status and the decoded credential subject.
Verifies an SD-JWT Verifiable Credential. Accepts the compact serialisation (header.payload.signature~disclosure~...) and returns which fields were selectively disclosed, whether the EdDSA signature is valid, and the decoded claims.
Returns a summary of customs-relevant product data: HS tariff code, country of origin, materials declaration, and ESPR compliance status. Designed for use by customs authorities, EU border inspection posts, and trade compliance systems. No authentication required.
Parameters
Name
In
Type
Description
dpp_code
path
string
DPP identifier
Request · Response
Request
GET /api/v1/public/customs/verify/DPP-09506000134352-SN-001 HTTP/1.1
Host: api.passportlab.io
EPCIS 2.0-compliant supply chain event log. Each DPP accumulates traceability events (ObjectEvent, TransformationEvent, AggregationEvent) from all stakeholders in the supply chain. These events are export-ready in EPCIS 2.0 Document format.
Returns the full EPCIS 2.0 Document for a DPP — all recorded supply chain events from manufacture to retail. Compatible with GS1-certified EPCIS repositories. The response follows the EPCIS 2.0 JSON-LD context. Stakeholder-key filtering applies: customs authorities and MSAs can access additional event metadata.
Parameters
Name
In
Type
Description
dpp_code
path
string
DPP identifier
Headers
Name
Required
Description
X-Stakeholder-Key
No
Stakeholder key for role-filtered event visibility (customs, msa, retailer, notified_body).
Request · Response
Request
GET /api/v1/dpp/DPP-09506000134352-SN-001/events/document HTTP/1.1
Host: api.passportlab.io
Accept: application/json
Search the EU NANDO database of notified conformity assessment bodies. Use this to look up which laboratories and certification bodies are authorised to issue conformity certificates for specific EU legislation.
GET/api/v1/public/nando/searchEU NANDO Database • New Legislative Framework
Searches the list of EU-recognised notified bodies indexed by PassportLab. Returns name, notified body number, country, and the EU directives/regulations they are accredited for. Currently covers 28 bodies across ESPR-relevant product categories.
Parameters
Name
In
Type
Description
q
query
string
Search term (body name, country, or directive number)
country
query
string
ISO 3166-1 alpha-2 country code filter (e.g. DE, FR, IT)
Request · Response
Request
GET /api/v1/public/nando/search?q=battery&country=DE HTTP/1.1
Host: api.passportlab.io
PassportLab maps each credential and data format to the EU standard that governs it (EN 18223 §4 — Interoperability Requirements). Use this table to understand which protocol to use for each integration.
Standard / Protocol
Role in PassportLab
EN 18223 reference
W3C VC v2.0 (eddsa-jcs-2022)
Primary credential format for DPP assertions. Ed25519 signed, JSON-LD serialisation. Used by customs, MSAs, and notified bodies for offline verification.
§4.2 — Verifiable Credentials
SD-JWT VC (IETF draft)
Selective disclosure — share only the fields required by a given stakeholder (e.g. carbon footprint to customs, not supply chain origin to consumers).
§4.3 — Selective Disclosure
GS1 Digital Link 1.1
Physical-to-digital bridge. QR codes encode a GS1 DL URL (/01/{gtin}/21/{serial}) that resolves to the DPP. Compatible with any GS1-certified scanner.
§4.4 — Product Identifiers
UNTP v0.7.0
UN Transparency Protocol credential types: DigitalProductPassport, DigitalConformityCredential, DigitalTraceabilityEvent. Manifest at /.well-known/untp-conformance.json.
§4.5 — Traceability Credentials
EPCIS 2.0 (GS1 CBV 2.0)
Supply chain event log. All events (ObjectEvent, AggregationEvent, TransformationEvent) are exported as EPCIS 2.0 Documents with JSON-LD context.
§4.6 — Event Log
AAS Part 2 (IEC 63278)
Asset Administration Shell export (/aas.json). Five submodels: Nameplate, TechnicalData, CarbonFootprint, Circularity, EnergyConsumption. Required for Catena-X and IDSA data spaces.
§4.7 — Digital Twin Shell
DID:Web (W3C)
Platform-level and per-organisation decentralised identifiers. Resolves to an Ed25519 public key. Verifiers resolve /.well-known/did.json to verify signatures without contacting PassportLab.
§4.2 — Issuer Identity
SHACL (W3C)
Data shape validation. Shapes for battery, electronics, textile, steel, and construction categories published at /public/schemas/shacl/{category}.ttl.