Within v1 every change is additive; anything breaking would ship as v2 with advance notice. Subscribe to the specification URL in your CI to see additions as they land.
Follow changes
Atom feed
Every release of this changelog, for a feed reader, Slack or Teams.
Watch the spec in CI
The OpenAPI 3.1 document is public. Hash it in CI and the build tells you the day an endpoint or field is added.
dppapi-production.up.railway.app/v1/openapi.jsonAPI status
GET /health/ready answers 200 with "status": "ready" when passports can be served, and 503 when the database is unreachable. Point an uptime check at it.
v1.0.0
- addedThe public REST API under
/v1, authenticated with organisation API keys carryingreadandwritescopes. - addedLive (
dpp_live_…) and test (dpp_test_…) keys; test keys dry-run every write.X-DPP-Dry-Runfor single dry runs with a live key;X-DPP-Modeon every response. - addedIdempotency keys on POST and PATCH, stored for 24 hours, with
Idempotent-Replayedon replays. - added
X-Request-Idon every response andrequest_idin every/v1error body. - addedCursor pagination (
limit,cursor,has_more,next_cursor) on list endpoints. - addedModels: list, create, read, update, validate and missing-field analysis. Documents: upload, list, download.
- addedBatteries: create one or up to 1,000, each with its own passport and unique identifier.
- addedPassports: list with incremental-sync filters, read, publish (single and bulk) behind the publish gate, status changes with linked successor passports, recycling, QR codes and the version archive.
- addedDynamic data events, including the telemetry fields
capacityThroughput,timeExtremeHighTemp,timeExtremeLowTemp,timeChargingExtremeHighTempandtimeChargingExtremeLowTemp. - addedFleet operations: bulk lifecycle events and matched row updates, with per-row results.
- addedSigned webhooks for passports, models, documents and supplier submissions, with retries, a delivery log, resend, secret rotation and a
pingtest event — managed in the app or under/webhooks. - addedFacilities:
GET /plantsandPOST /plants. - addedSupplier requests:
GET /upload-links,POST /upload-links,GET /upload-links/{id}/filesandPOST /upload-links/{id}/accept. - added
X-DPP-Api-Versionon every/v1response. - addedAudit trail, JSON export and ZIP archive over the API.
- added
GET /field-catalog: the 71 EU data points with obligation per category, field mapping and access tier. - addedRate limits: 600 requests per minute per live key, 60 per test key.