Skip to content

Standards

EN 18222: Passport APIs and Lifecycle

Which API operations EN 18222 defines — create, read, update, search, version queries and registry submission — and how to evaluate a platform against them.

By IDPP · · Updated: · 2 min read

EN 18222:2026 defines passport lifecycle management and searchability APIs. When you ask what a platform must be able to do, the answer largely lives in this standard.

Operations

OperationWhat it does
CreateCreates a new passport record
ReadReturns the passport for a given identifier
UpdateUpdates fields by creating a new version
SearchFinds passports by criteria
Bulk retrieveFetches many at once (a batch, for example)
Version queryReturns the version as of a given date
Registry submitSends the identifier and hosting address to the EU registry

See the EU DPP Registry guide and EN 18216 data exchange.

Why version queries matter

The most common question in an audit is: "what did you declare on the date this product was placed on the market?" Answering that requires a version query in the API.

A system that returns only "current state" is incomplete for audit purposes. See audit trails and versioning and EN 18221 archiving.

Platform evaluation questions

Concrete questions drawn from this standard:

  1. Can I retrieve the version as of a specific date through the API?
  2. Can I do bulk updates (renewing a certificate across 5,000 SKUs)?
  3. Is registry submission automatic or manual?
  4. Which fields can be searched?
  5. What is the API versioning policy, and is backward compatibility guaranteed?

See choosing DPP software.

Relationship to access tiers

API operations work together with the access tier policy: the same read call returns a different field set depending on the caller's role. FprEN 18239 defines that layer. See access rights and roles.

Frequently asked questions

Should I expose the API to consumers?

The public tier is already open to everyone, and machine access uses content negotiation — a separate consumer API is not needed. See what a resolver service is.

Are there limits on bulk operations?

The standard defines the operation; limits are an implementation choice. At high SKU counts, bulk retrieval and pagination design matter.

When should registry submission be triggered?

When the passport is published and the identifier first used — and again on update if the hosting address changed. See registering a DPP step by step.

Get your products passport-ready

IDPP lets you build, publish and register ESPR- and EN 1821x-aligned digital product passports with the EU DPP Registry.

Start for free What is IDPP?