REST API v1

REST API Documentation

Automate your battery passport workflow. Create, update, publish and export products via REST API.

Authentication

Scale plan required. Generate keys in your organization settings.

Authorization: Bearer dpp_live_...

Base URL

120 requests/minute per organization.

https://app.dpphero.com/api/v1

Quick Example

curl -X POST https://app.dpphero.com/api/v1/products \
  -H "Authorization: Bearer dpp_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "LFP Module 48V",
    "serial_number": "BAT-2025-001",
    "battery_category": "industrial",
    "manufacturing_date": "2025-06-15",
    "battery_mass": 45.5
  }'

Available Endpoints

All endpoints require a Bearer token (API key). Available on the Scale plan.

Products

GET/products
POST/products
GET/products/{id}
PATCH/products/{id}
DELETE/products/{id}
POST/products/{id}/image
DELETE/products/{id}/image
POST/products/{id}/files

Battery Condition

Update dynamic BMS data like state of charge, cycle count and capacity fade via API.

GET/products/{id}/condition
PATCH/products/{id}/condition

Bulk Import

POST/products/bulk

Export

GET/products/{id}/export/json
GET/products/{id}/export/pdf
GET/products/{id}/export/qr

Organization

GET/organization
GET/facilities
GET/audit-log

Full Documentation

The complete API reference with field definitions, example payloads, error codes, auto-fill rules and the DIN SPEC 99100 product schema is available in your dashboard.

View plansLog in to access documentation