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

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 preferences

You choose which cookies are used. You can change your choice at any time with “Cookie settings” in the footer. Privacy policy

Necessary

Always on

Needed for the site to work: your light/dark theme and this cookie choice are stored in your browser. They do not track you.

Analytics

Google Analytics 4 measures how pages are used through statistics, which helps us improve the site. If you accept, it sets cookies and measures your visit in full. If you decline, it sets no cookies, but Google may still receive technical data such as the page viewed, your browser type and IP address.

_ga, _ga_* · up to 2 years · Google