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

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

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",

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