Developers · Tools

Passport JSON and JSON-LD viewer

A published battery passport as the public resolver returns it, JSON and JSON-LD side by side, with each property traced to its EU data point, Annex XIII point and access tier.

Version
v1.0.0
Base URL
https://dppapi-production.up.railway.app/v1
Format
JSON · OpenAPI 3.1
FeedbackLast updated

Cet article n'est pas encore disponible en français ; il est affiché ci-dessous en anglais.

On this pageViewer

This is what the QR code on a battery resolves to. The public resolver serves the same passport two ways: JSON at /p/{uniqueIdentifier} and JSON-LD at /p/{uniqueIdentifier}.jsonld (or the same URL with Accept: application/ld+json). Point at any property to see which EU data point it carries and who may see it.

Viewer

Example passportAn LMT battery, Point 1 data only — what anyone scanning the QR code receives.

Point at a property in either pane — or focus a pane and use the arrow keys — to see where it comes from.

JSON

GET https://dppapi-production.up.railway.app/p/C-7KQ2M9XHT4R

{
"uniqueIdentifier": "C-7KQ2M9XHT4R",
"templateKey": "battery",
"category": "LMT",
"status": "ORIGINAL",
"lifecycleState": "ACTIVE",
"publishedAt": "2027-01-15T10:02:11.000Z",
"organization": {
"legalName": "Example Batteries GmbH",
"country": "Germany",
"contact": "service@example-batteries.eu"
},
"model": {
"name": "Cargo 48V 15Ah",
"capacityKwh": 0.72,
"chemistry": "Lithium-ion NMC"
},
"values": {
"manufacturerName": "Example Batteries GmbH",
"manufacturerAddress": "Industriestraße 12, 70565 Stuttgart, Germany",
"manufacturerContact": "https://example-batteries.eu · service@example-batteries.eu",
"modelDesignation": "C48-15",
"weightKg": 4.2,
"hazardousSubstances": "None above reporting thresholds",
"extinguishingAgent": "Water, foam",
"criticalRawMaterials": "Cobalt, lithium, natural graphite",
"renewableContentShare": 0,
"ratedCapacity": 15,
"nominalVoltage": 48,
"minVoltage": 39,
"maxVoltage": 54.6,
"powerCapability": 1500,
"powerLimits": "1.5 kW continuous / 2.2 kW peak, −10 °C to 45 °C",
"expectedLifetimeCycles": 1200,
"referenceTestForLifetime": "IEC 62660-1, 25 °C, 100% DoD",
"labelMarkings": "Separate collection symbol (crossed-out wheeled bin); capacity 15 Ah; CE",
"tempRangeNotInUse": "−20 °C to 45 °C",
"warrantyCalendarPeriod": "3 years",
"roundTripEfficiencyInitial": 95,
"roundTripEfficiency50pct": 92,
"internalResistanceCell": 1.8,
"internalResistancePack": 38,
"cRateCycleLifeTest": "0.5C charge / 1C discharge",
"wasteManagementInfo": "Return to the retailer or a municipal collection point; do not dispose of with household waste."
},
"documents": [
{
"id": "cm1q9a3fz0011l70fk8m2n4p6",
"name": "DoC C48-15.pdf",
"type": "EU Declaration of Conformity"
}
],
"parents": []
}

JSON-LD

GET https://dppapi-production.up.railway.app/p/C-7KQ2M9XHT4R.jsonld

{
"@context": {
"@vocab": "https://dpp.eu/vocab/battery#",
"schema": "https://schema.org/"
},
"@type": "BatteryPassport",
"@id": "https://dppapi-production.up.railway.app/p/C-7KQ2M9XHT4R",
"uniqueIdentifier": "C-7KQ2M9XHT4R",
"category": "LMT",
"status": "ORIGINAL",
"lifecycleState": "ACTIVE",
"datePublished": "2027-01-15T10:02:11.000Z",
"manufacturer": {
"@type": "schema:Organization",
"name": "Example Batteries GmbH",
"addressCountry": "Germany",
"contactPoint": "service@example-batteries.eu"
},
"model": {
"name": "Cargo 48V 15Ah",
"energyCapacityKwh": 0.72,
"chemistry": "Lithium-ion NMC"
},
"dppVersion": {
"versionNumber": 1,
"contentHash": "sha256:9f2c4e1a7b3d5c8e0f6a2b4d9c1e3f5a7b9d0c2e4f6a8b1c3d5e7f9a0b2c4d6e",
"recordedAt": "2027-01-15T10:02:11.000Z"
},
"properties": {
"manufacturerName": "Example Batteries GmbH",
"manufacturerAddress": "Industriestraße 12, 70565 Stuttgart, Germany",
"manufacturerContact": "https://example-batteries.eu · service@example-batteries.eu",
"modelDesignation": "C48-15",
"weightKg": 4.2,
"hazardousSubstances": "None above reporting thresholds",
"extinguishingAgent": "Water, foam",
"criticalRawMaterials": "Cobalt, lithium, natural graphite",
"renewableContentShare": 0,
"ratedCapacity": 15,
"nominalVoltage": 48,
"minVoltage": 39,
"maxVoltage": 54.6,
"powerCapability": 1500,
"powerLimits": "1.5 kW continuous / 2.2 kW peak, −10 °C to 45 °C",
"expectedLifetimeCycles": 1200,
"referenceTestForLifetime": "IEC 62660-1, 25 °C, 100% DoD",
"labelMarkings": "Separate collection symbol (crossed-out wheeled bin); capacity 15 Ah; CE",
"tempRangeNotInUse": "−20 °C to 45 °C",
"warrantyCalendarPeriod": "3 years",
"roundTripEfficiencyInitial": 95,
"roundTripEfficiency50pct": 92,
"internalResistanceCell": 1.8,
"internalResistancePack": 38,
"cRateCycleLifeTest": "0.5C charge / 1C discharge",
"wasteManagementInfo": "Return to the retailer or a municipal collection point; do not dispose of with household waste."
},
"documents": [
{
"id": "cm1q9a3fz0011l70fk8m2n4p6",
"name": "DoC C48-15.pdf",
"type": "EU Declaration of Conformity"
}
],
"derivedFrom": []
}

Load a real passport

The identifier printed under the QR code, or the whole resolver URL. Requests go from your browser to the public resolver; no key is used.

Paste a response instead

JSON and JSON-LD

JSONJSON-LDNote
organizationmanufacturerTyped schema:Organization; legalName becomes name, country addressCountry, contact contactPoint.
publishedAtdatePublishedISO 8601.
model.capacityKwhmodel.energyCapacityKwhRated capacity in Ah is a separate value, ratedCapacity.
valuespropertiesThe public (Point 1) template values, keyed by API field name.
parentsderivedFromPredecessor passports after repurposing or remanufacturing.
—dppVersionThe archived version this document represents, with its SHA-256 content hash.
templateKey—JSON only.

Both carry a weak ETag and are cacheable; an unknown or unpublished identifier answers 404, a recycled battery’s passport 410. The JSON-LD context is a minimal Battery-Pass-style vocabulary that will be replaced by the semantic model the Commission publishes.

What is public

Only Annex XIII Point 1 values reach the resolver, and only those that are set. Data points marked N/A for every category in the EU guidance (such as the repeated material composition) are never shown, even when stored. Points 2 to 4 — detailed composition, dismantling information, test reports, state of health — stay on the server and are readable only with your own key through GET /passports/{id}. The field catalogue lists every Point 1 field.

Préférences en matière de cookies

Vous choisissez les cookies utilisés. Vous pouvez modifier votre choix à tout moment via « Paramètres des cookies » en bas de page. Politique de confidentialité

Nécessaires

Toujours actifs

Indispensables au fonctionnement du site : votre thème clair/sombre et ce choix de cookies sont enregistrés dans votre navigateur. Ils ne servent pas à vous suivre.

Analyse

Google Analytics 4 mesure l’utilisation des pages au moyen de statistiques, ce qui nous aide à améliorer le site. Si vous acceptez, il dépose des cookies et mesure votre visite en détail. Si vous refusez, il ne dépose aucun cookie, mais Google peut tout de même recevoir des données techniques, comme la page consultée, le type de navigateur et l’adresse IP.

_ga, _ga_* · jusqu’à 2 ans · Google