Dieser Artikel liegt noch nicht auf Deutsch vor und wird unten auf Englisch angezeigt.
On this pageRegulation
The regulatory terms behind the API’s field names and rules, and the API’s own vocabulary. Regulatory terms link to their full definitions.
Regulation
| Term | Meaning here |
|---|---|
| Battery passport | The electronic record of one physical battery required by Regulation (EU) 2023/1542. In the API: a passport, one per battery item. |
| Article 77 | The article that creates the passport. 77(1): one per individual battery. 77(7): a repurposed or remanufactured battery gets a new passport linked to the old. 77(8): the passport ceases when the battery is recycled. |
| Annex XIII | The list of passport content, in four points. Point 1 public information; Point 2 information for persons with a legitimate interest and authorities; Point 3 authority-only information such as test-report results; Point 4 battery-specific data, including dynamic data such as state of health. |
| Access tier | Who may see a data point, following Annex XIII: PUBLIC (Point 1), LEGITIMATE_INTEREST (Points 2 and 4) and AUTHORITY (Point 3). Enforced on the server; the public resolver serves PUBLIC only. |
| Legitimate interest | The standing of repairers, remanufacturers, second-life operators and recyclers to access more than the public tier. |
| Unique identifier | The string that identifies one physical battery (ISO/IEC 15459). In the API: uniqueIdentifier, C- + 11 characters. Never changes. |
| UPI (unique product identifier) | The identifier a passport is registered under in the EU DPP Registry (Impl. Reg. (EU) 2026/1778 Art. 8). The Registry requires a URL starting with https://, at most 50 characters, that resolves to the hosted passport — the reason identifiers are kept short. |
| Data carrier | The QR code (ISO/IEC 18004) on the battery that encodes the resolver URL. In the API: GET /passports/{id}/qr.svg. |
| Economic operator | The organisation responsible for the battery and its passport — your organisation. In the API: responsibleOrgId. |
| Placing on the market | Making a battery available on the EU market for the first time. In the API: placedOnMarketAt; Point 4(a) values are measured at this moment. |
| State of health | The battery’s condition relative to new. EV: state of certified energy. LMT: remaining capacity, power capability, round-trip efficiency. In the API: SOH_READING events. |
| Repurposing | A battery gets a second life for a different purpose. In the API: PATCH /passports/{id}/status with REPURPOSED, which forks a linked passport. |
| Declaration of conformity | The EU Declaration of Conformity, a required document (Annex XIII 1(r)). In the API: a document of type "EU Declaration of Conformity". |
| Notified body / market surveillance authority | The authorities with access to Point 3 data. |
| Battery categories | EV, LMT and industrial batteries above 2 kWh need a passport. In the API: category. |
API
| Term | Meaning |
|---|---|
| Model | A battery design: the data every battery of the design shares. |
| Battery item | One physical battery. Creating one creates its passport. |
| Draft / published | A new passport is a draft: private and not billed. Publishing makes it public and counts it as issued. |
| Publish gate | The server-side check before publishing: a place of manufacture, and a model complete for its category. |
| Ceased | A recycled battery’s passport. The resolver answers 410 Gone. |
| Fork | The new, linked passport created on repurpose, re-use or remanufacture. |
| Event | One append-only record of dynamic data. |
| Live / test key | A live key stores writes; a test key dry-runs them. Details. |
| Dry run | A write validated in full and not stored. |
| Idempotency key | A header that makes a retried write return its first response. Details. |
| Cursor | The opaque pointer to the next page of a list. Details. |
| Webhook | A signed HTTPS POST we send when something changes. Details. |