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

Este artículo aún no está disponible en español; se muestra a continuación en inglés.

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.

Preferencias de cookies

Tú decides qué cookies se usan. Puedes cambiar tu elección en cualquier momento desde «Configuración de cookies» en el pie de página. Política de privacidad

Necesarias

Siempre activas

Imprescindibles para que el sitio funcione: tu tema claro/oscuro y esta elección de cookies se guardan en tu navegador. No sirven para rastrearte.

Analítica

Google Analytics 4 mide cómo se usan las páginas mediante estadísticas, lo que nos ayuda a mejorar el sitio. Si aceptas, instala cookies y mide tu visita por completo. Si rechazas, no instala cookies, pero Google aún puede recibir datos técnicos como la página vista, el tipo de navegador y la dirección IP.

_ga, _ga_* · hasta 2 años · Google