Developers · API endpoints

Account and catalogue

GET /me and GET /field-catalog: who a key belongs to, its mode, plan, usage and rate limit, and the 71 EU data points.

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

Dieser Artikel liegt noch nicht auf Deutsch vor und wird unten auf Englisch angezeigt.

Two read-only endpoints every integration calls first: who the key belongs to, and the EU data points the API maps to.

Personalise the samples. Paste a test key and every snippet uses it — and your own model and passport ids.

GET/v1/me
read scope

Who am I

The calling key (name, prefix, scopes, mode), your organisation, your plan and its features, this year’s usage against what the plan includes, your rate limit and the API version. Use it as the health check when an integration starts.

The X-DPP-Mode response header says live or test, so you can assert in code that production runs with a live key.

Responses

  • 200OK — The key and its organisation.

Errors1

Response fields · 200

object
  • apiVersionstring
GET /v1/me
curl "https://dppapi-production.up.railway.app/v1/me" \-H "Authorization: Bearer $DPP_API_KEY"
200 OK · The key and its organisation.
{"apiKey": {"name": "SAP production","prefix": "dpp_test_3f9a","scopes": ["read", "write"],"mode": "test"},"organisation": {"id": "cm1q7v0aa0000l70f1a2b3c4d","legalName": "Example Batteries GmbH","country": "Germany","esprOperatorIdentifier": null},"plan": {"key": "CONNECTED","label": "Connected","status": "ACTIVE","features": ["create_models", "create_items", "publish", "supplier_requests", "erp_api"]
GET/v1/field-catalog
read scope

EU data-point catalogue

The 71 data points of the EU guidance "Digital Batteries Passport – data points by category" v2.0, each with its obligation per category and where it lives in this API. Template fields carry their label, type, unit, granularity, Annex XIII point, access tier and the endpoint that writes them.

location.kind is one of field, model_attribute, document, managed, repetition or not_yet_applicable. See the field catalogue for the same table, readable.

Parameters1

  • category"EV" | "LMT" | "INDUSTRIAL"queryoptional

    Return only this category’s obligation for each data point.

Responses

  • 200OK — The catalogue (abridged to two data points).

Errors1

GET /v1/field-catalog
curl "https://dppapi-production.up.railway.app/v1/field-catalog?category=LMT" \-H "Authorization: Bearer $DPP_API_KEY"
200 OK · The catalogue (abridged to two data points).
{"source": {"title": "Guidance Document: Digital Batteries Passport – data points by category","publisher": "European Commission, DG GROW","version": "2.0","date": "2026-08-15"},"categories": ["EV", "LMT", "INDUSTRIAL"],"dataPoints": [{"number": 11,"name": "Capacity","obligation": { "EV": "required", "LMT": "required", "INDUSTRIAL": "required" },"location": {"kind": "field","fields": [{"name": "ratedCapacity",

Cookie-Einstellungen

Sie entscheiden, welche Cookies verwendet werden. Ihre Wahl können Sie jederzeit über „Cookie-Einstellungen“ im Footer ändern. Datenschutzerklärung

Notwendig

Immer aktiv

Für den Betrieb der Website erforderlich: Ihr Hell-/Dunkel-Design und diese Cookie-Auswahl werden in Ihrem Browser gespeichert. Sie dienen nicht dem Tracking.

Analyse

Google Analytics 4 misst über Statistiken, wie Seiten genutzt werden, und hilft uns, die Website zu verbessern. Wenn Sie zustimmen, setzt es Cookies und erfasst Ihren Besuch vollständig. Wenn Sie ablehnen, setzt es keine Cookies, doch Google kann weiterhin technische Daten erhalten, etwa die aufgerufene Seite, Ihren Browsertyp und Ihre IP-Adresse.

_ga, _ga_* · bis zu 2 Jahre · Google