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

On this pageThe endpoint

The European Commission’s guidance “Guidance Document: Digital Batteries Passport – data points by category” (v2.0, 15 August 2026) lists 71 data pointsand says, for each battery category, whether it must be filled from February 2027. The API follows that table one to one: every data point has a defined place in the API, and the obligation for your model’s category drives the completeness report.

Data points: 71
Required · EV: 47
Required · LMT: 50
Required · Industrial: 32

The endpoint

GET /field-catalog serves the same table as data, so an integration can map its own columns against it — and notice when the guidance changes — instead of hard-coding a list. Each data point carries its obligation per category and a location: a field (with its API name, label, type, unit, granularity, Annex XIII point, access tier and the endpoint that writes it), a model_attribute, a document, a platform-managed value, a repetition of another point, or not_yet_applicable. Add ?category=LMTto get one category’s obligations only. The full response is documented under Account and catalogue.

curl "https://dppapi-production.up.railway.app/v1/field-catalog?category=LMT" \-H "Authorization: Bearer $DPP_API_KEY"

Where values go

A passport is assembled from three layers. The catalogue tells you which layer each data point belongs to; the API field name is the key you use in that layer.

Layer	Written with	Holds
Model	`POST /models`, `PATCH /models/{id}` — in `fields`	Design data every battery of the model shares: manufacturer, weight, capacity, voltages, composition, dismantling information.
Battery	`POST /items` — in `fields`, plus place and date of manufacture	Values of one physical battery at the moment it is placed on the market: measured capacity, power, resistance and their fade.
Events	`POST /passports/{id}/events` — in `payload`	Dynamic data over the battery’s life: state of health, cycle count, state of charge, temperature, negative events. Appended, never overwritten.

A few data points are core properties rather than template fields — category and chemistry on the model, identifier, place and date of manufacture on the battery, status on the passport — and the EU Declaration of Conformity is a document uploaded with POST /models/{id}/documents.

Obligations

Value	In the guidance	Effect in the API
Required	Mandatory	Listed under `missing` in the completeness report until filled.
If applicable	Optional, if applicable, or only applicable for some	Listed under `conditionalUnset` as a prompt, never a blocker.
N/A	Not to be filled or displayed as of February 2027	Accepted and stored if sent, not counted, not shown on the public page.

Access tiers

Annex XIII decides who may see each data point. The tier is enforced on the server: the public resolver only ever returns public-tier data, whatever is stored.

Tier	Annex XIII	Who sees it
`PUBLIC`	Point 1	Anyone who scans the QR code.
`LEGITIMATE_INTEREST`	Points 2 and 4	Persons with a legitimate interest, such as repairers and recyclers, and authorities.
`AUTHORITY`	Point 3	Notified bodies, market surveillance authorities and the Commission.

Your own API key always sees every tier of your own passports, through GET /passports/{id}.

Event types

Each event has an eventType and a payload object keyed by API field names. These are the types and the dynamic data points that belong to each:

eventType	Use	Payload keys
`SOH_READING`	State of health readings.	`stateOfCertifiedEnergyremainingCapacitycapacityFaderemainingPowerCapabilityremainingRoundTripEfficiencyselfDischargeEvolutionohmicResistance`
`CYCLE_COUNT`	Charge and discharge cycles so far.	`cycleCount`
`LIFETIME_METRIC`	Cumulative lifetime figures.	`energyThroughputcapacityThroughput`
`OPERATING_CONDITION`	Recorded operating conditions and time spent at extreme temperatures.	`stateOfChargeoperatingTemperaturetimeExtremeHighTemptimeExtremeLowTemptimeChargingExtremeHighTemptimeChargingExtremeLowTemp`
`NEGATIVE_EVENT`	Accidents and other negative events.	`negativeEvent`
`PUT_INTO_SERVICE`	The battery went into service.	`date`
`STATUS_CHANGE`	A change of status, recorded in the history.	`status`
`REPAIR`	A repair carried out on the battery.	Free-form
`PERFORMANCE_VALUE`	Any other performance reading.	Free-form

Explore all 71 data points

Numbered as in the guidance. Filter by category, obligation, Annex XIII point, access tier or kind of value, or search for a name, number, API field or event type; the filters are kept in the address, so a filtered view can be shared, and Export CSV downloads exactly the rows shown. Each API field links here as #field-<name> and each data point as #dp-<number>; “Written by” links to the call that sets the value.

The EU battery passport data points, with where each goes in the API
#	Data point · API field	Obligation · tier	Written by
1	1Unique identifier Core property Minted when the battery is created (or brought over with POST /items); never changes. `uniqueIdentifier`	EV Required LMT Required Industrial Required	Written by POST/itemsminted, or supplied when migrating POST/items/batch
2	2Identity of who is registering / responsible Core property Set from the organisation that owns the API key. `responsibleOrgId`	EV Required LMT Required Industrial Required	Written by GET/meset from the key’s organisation
3	3Manufacturer name Static · model `manufacturerName`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
4	4Manufacturer postal address Static · model `manufacturerAddress`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
5	5Manufacturer web and email address Static · model `manufacturerContact`	EV If applicable LMT If applicable Industrial If applicable Public · Point 1	Written by POST/models PATCH/models/{id}
6	6Battery category Core property `category`	EV Required LMT Required Industrial Required	Written by POST/modelscategory
7	7Model identification and batch/serial number Static · model `modelDesignation`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
8	8Place of manufacture Core property `placeOfManufacture`	EV Required LMT Required Industrial Required	Written by POST/items POST/items/batch
9	9Date of manufacture (month and year) Core property `dateOfManufacture`	EV Required LMT Required Industrial Required	Written by POST/items POST/items/batch
10	10Weight Static · model `weightKg`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
11	11Capacity Static · model `ratedCapacity`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
12	12Chemistry Core property `chemistry`	EV Required LMT Required Industrial Required	Written by POST/models PATCH/models/{id}
13	13Hazardous substances (other than Hg, Cd, Pb) Static · model `hazardousSubstances`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
14	14Usable extinguishing agent Static · model `extinguishingAgent`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
15	15Critical raw materials > 0.1% w/w Static · model `criticalRawMaterials`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
16	16Material composition (repetition) Static · model `materialCompositionPublic`	EV N/A LMT N/A Industrial N/A Public · Point 1	Written by POST/models PATCH/models/{id}
17	17Carbon footprint declaration Not filled in v1 Not to be filled as of February 2027.	EV N/A LMT N/A Industrial N/A	Written byNot written in v1
18	18Carbon footprint label Not filled in v1 Not to be filled as of February 2027.	EV N/A LMT N/A Industrial N/A	Written byNot written in v1
19	19Responsible sourcing (due-diligence report) Static · model `responsibleSourcingReportUrl`	EV N/A LMT N/A Industrial N/A Public · Point 1	Written by POST/models PATCH/models/{id}
20	20Recycled cobalt share Not filled in v1 Not to be filled as of February 2027.	EV N/A LMT N/A Industrial N/A	Written byNot written in v1
21	21Recycled lithium share Not filled in v1 Not to be filled as of February 2027.	EV N/A LMT N/A Industrial N/A	Written byNot written in v1
22	22Recycled nickel share Not filled in v1 Not to be filled as of February 2027.	EV N/A LMT N/A Industrial N/A	Written byNot written in v1
23	23Recycled lead share Not filled in v1 Not to be filled as of February 2027.	EV N/A LMT N/A Industrial N/A	Written byNot written in v1
24	24Share of renewable content Static · model `renewableContentShare`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
25	25Rated capacity in Ah (repetition of 11) Not filled in v1 Repetition of data point 11; not filled separately.	EV N/A LMT N/A Industrial N/A	Written byNot written in v1
26	26Minimal voltage Static · model `minVoltage`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
27	27Nominal voltage Static · model `nominalVoltage`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
28	28Maximum voltage Static · model `maxVoltage`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
29	29Original power capability (W) Static · model `powerCapability`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
30	30Power limits Static · model `powerLimits`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
31	31Expected lifetime in cycles Static · model `expectedLifetimeCycles`	EV Required LMT Required Industrial If applicable Public · Point 1	Written by POST/models PATCH/models/{id}
32	32Reference test for expected lifetime Static · model `referenceTestForLifetime`	EV Required LMT Required Industrial If applicable Public · Point 1	Written by POST/models PATCH/models/{id}
33	33Capacity threshold for exhaustion Static · model `capacityThresholdExhaustion`	EV Required LMT N/A Industrial N/A Public · Point 1	Written by POST/models PATCH/models/{id}
34	34Temperature range when not in use Static · model `tempRangeNotInUse`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
35	35Commercial warranty period Static · model `warrantyCalendarPeriod`	EV If applicable LMT If applicable Industrial If applicable Public · Point 1	Written by POST/models PATCH/models/{id}
36	36Initial round-trip energy efficiency Static · model `roundTripEfficiencyInitial`	EV Required LMT Required Industrial If applicable Public · Point 1	Written by POST/models PATCH/models/{id}
37	37Round-trip efficiency at 50% of cycle-life Static · model `roundTripEfficiency50pct`	EV Required LMT Required Industrial If applicable Public · Point 1	Written by POST/models PATCH/models/{id}
38	38Internal cell and pack resistance Static · model `internalResistanceCell` `internalResistancePack`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
39	39C-rate of the cycle-life test Static · model `cRateCycleLifeTest`	EV Required LMT Required Industrial If applicable Public · Point 1	Written by POST/models PATCH/models/{id}
40	40Marking requirements, Art. 13(4) Static · model `labelMarkings`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
41	41Marking requirements, Art. 13(5) (Cd/Pb symbol) Static · model `markingRequirements`	EV If applicable LMT If applicable Industrial If applicable Public · Point 1	Written by POST/models PATCH/models/{id}
42	42EU declaration of conformity Document POST /models/{id}/documents · type "EU Declaration of Conformity"	EV Required LMT Required Industrial Required	Written by POST/models/{id}/documentstype "EU Declaration of Conformity"
43	43Waste prevention and management information Static · model `wasteManagementInfo`	EV Required LMT Required Industrial Required Public · Point 1	Written by POST/models PATCH/models/{id}
44	44Instructions for use Not filled in v1 On hold in the guidance; not filled.	EV N/A LMT N/A Industrial N/A	Written byNot written in v1
45	45Detailed composition Static · model `detailedComposition`	EV Required LMT Required Industrial Required Legitimate interest · Point 2	Written by POST/models PATCH/models/{id}
46	46Part numbers for components Static · model `componentPartNumbers`	EV Required LMT Required Industrial Required Legitimate interest · Point 2	Written by POST/models PATCH/models/{id}
47	47Contact details of sources for replacement spares Static · model `sparePartNumbersContacts`	EV Required LMT Required Industrial Required Legitimate interest · Point 2	Written by POST/models PATCH/models/{id}
48	48Dismantling information Static · model `dismantlingInfo`	EV Required LMT Required Industrial Required Legitimate interest · Point 2	Written by POST/models PATCH/models/{id}
49	49Safety measures Static · model `safetyMeasures`	EV Required LMT Required Industrial Required Legitimate interest · Point 2	Written by POST/models PATCH/models/{id}
50	50Results of test reports Static · model `testReportSummary`	EV Required LMT Required Industrial Required Authority · Point 3	Written by POST/models PATCH/models/{id}
51	51Rated capacity (dynamic) Static · battery `measuredCapacityAtPlacing`	EV Required LMT Required Industrial If applicable Legitimate interest · Point 4	Written by POST/items POST/items/batch
52	52Capacity fade Static · battery `capacityFadeAtPlacing`	EV Required LMT Required Industrial If applicable Legitimate interest · Point 4	Written by POST/items POST/items/batch
53	53Power Static · battery `powerAtPlacing`	EV Required LMT Required Industrial If applicable Legitimate interest · Point 4	Written by POST/items POST/items/batch
54	54Power fade Static · battery `powerFadeAtPlacing`	EV Required LMT Required Industrial If applicable Legitimate interest · Point 4	Written by POST/items POST/items/batch
55	55Internal resistance Static · battery `measuredResistanceAtPlacing`	EV Required LMT Required Industrial If applicable Legitimate interest · Point 4	Written by POST/items POST/items/batch
56	56Internal resistance increase Static · battery `internalResistanceIncreaseAtPlacing`	EV Required LMT Required Industrial If applicable Legitimate interest · Point 4	Written by POST/items POST/items/batch
57	57Energy round-trip efficiency Static · battery `energyRoundTripEfficiencyAtPlacing`	EV If applicable LMT If applicable Industrial If applicable Legitimate interest · Point 4	Written by POST/items POST/items/batch
58	58Energy round-trip efficiency fade Static · battery `energyRoundTripEfficiencyFadeAtPlacing`	EV If applicable LMT If applicable Industrial If applicable Legitimate interest · Point 4	Written by POST/items POST/items/batch
59	59Expected lifetime under reference conditions (cycles) Static · battery `expectedLifetimeCyclesAtRef`	EV Required LMT Required Industrial If applicable Legitimate interest · Point 4	Written by POST/items POST/items/batch
60	60Expected lifetime under reference conditions (years) Static · battery `expectedLifetimeYearsAtRef`	EV Required LMT Required Industrial If applicable Legitimate interest · Point 4	Written by POST/items POST/items/batch
61	61State of health: state of certified energy (SOCE) Dynamic · event · SOH_READING `stateOfCertifiedEnergy`	EV Required LMT N/A Industrial N/A Legitimate interest · Point 4	Written by POST/passports/{id}/eventseventType SOH_READING
62	62State of health: remaining capacity Dynamic · event · SOH_READING `remainingCapacity`	EV N/A LMT Required Industrial If applicable Legitimate interest · Point 4	Written by POST/passports/{id}/eventseventType SOH_READING
63	63State of health: remaining power capability Dynamic · event · SOH_READING `remainingPowerCapability`	EV N/A LMT Required Industrial If applicable Legitimate interest · Point 4	Written by POST/passports/{id}/eventseventType SOH_READING
64	64State of health: remaining round-trip efficiency Dynamic · event · SOH_READING `remainingRoundTripEfficiency`	EV N/A LMT Required Industrial If applicable Legitimate interest · Point 4	Written by POST/passports/{id}/eventseventType SOH_READING
65	65State of health: evolution of self-discharging rates Dynamic · event · SOH_READING `selfDischargeEvolution`	EV N/A LMT Required Industrial If applicable Legitimate interest · Point 4	Written by POST/passports/{id}/eventseventType SOH_READING
66	66State of health: ohmic resistance Dynamic · event · SOH_READING `ohmicResistance`	EV N/A LMT Required Industrial If applicable Legitimate interest · Point 4	Written by POST/passports/{id}/eventseventType SOH_READING
67	67Status (original / repurposed / re-used / remanufactured / waste) Core property `status`	EV Required LMT Required Industrial Required	Written by POST/passports/{id}/status
68	68Number of charging and discharging cycles Dynamic · event · CYCLE_COUNT `cycleCount`	EV If applicable LMT If applicable Industrial If applicable Legitimate interest · Point 4	Written by POST/passports/{id}/eventseventType CYCLE_COUNT
69	69Negative events, such as accidents Dynamic · event · NEGATIVE_EVENT `negativeEvent`	EV If applicable LMT If applicable Industrial If applicable Legitimate interest · Point 4	Written by POST/passports/{id}/eventseventType NEGATIVE_EVENT
70	70Operating environmental conditions, including temperature Dynamic · event · OPERATING_CONDITION `operatingTemperature` `timeExtremeHighTemp` `timeExtremeLowTemp` `timeChargingExtremeHighTemp` `timeChargingExtremeLowTemp`	EV If applicable LMT If applicable Industrial If applicable Legitimate interest · Point 4	Written by POST/passports/{id}/eventseventType OPERATING_CONDITION
71	71State of charge Dynamic · event · OPERATING_CONDITION `stateOfCharge`	EV If applicable LMT If applicable Industrial If applicable Legitimate interest · Point 4	Written by POST/passports/{id}/eventseventType OPERATING_CONDITION

Source: European Commission, DG GROW, “Guidance Document: Digital Batteries Passport – data points by category”, version 2.0, 15 August 2026. Informational, not legal advice.

EU field catalogue

The endpoint

Where values go

Obligations

Access tiers

Event types

Explore all 71 data points

Préférences en matière de cookies

Nécessaires

Analyse