DP API reference

One API for distribution partners such as mobility apps, fleets and car makers: find chargers, show live availability and prices, start and stop charging, follow sessions live and see the money.


Base URL	`https://dp.networkcore.org`
Auth	`Authorization: Bearer <api_key>`
Format	JSON, amounts incl. IVA, ISO 8601 UTC

Integration levels

Data: locations, live availability and prices. No money moves and no sessions start. Fits maps, POI display and route planners.
Full charging: everything in Data, plus starting and stopping sessions, live session events and a read-only view of the money.

Group	Data	Full charging
Locations and availability	✓	✓
Prices	✓	✓
Data webhooks	✓	✓
Sessions		✓
Money		✓
Charging webhooks and live stream		✓

Conventions

Your order ID

Every session carries order_id: your own order or transaction ID. It is required, unique per partner, and comes back on every session, webhook, receivable and dispute. Sending the same order_id twice replays the first answer instead of starting a second charge.

Errors

One shape everywhere:

{ "error": { "code": "CHARGE_POINT_OCCUPIED",
             "message": "Charge point EVSE-01 already has an active session." } }

Headers

X-Correlation-ID on every response. Quote it when you report a problem.
Idempotent-Replayed: true when an answer is a replay of an earlier request.

Lists and syncing

limit and offset, with total_count in the response.
updated_since returns only what changed, for cheap delta syncs.

Session lifecycle

PENDING → ACTIVE → COMPLETED
        ↘ FAILED

Status	Meaning
`PENDING`	We sent the start to the charger and are waiting for it to confirm
`ACTIVE`	Energy is flowing
`COMPLETED`	The charger’s final record (CDR) arrived and the final amounts are known
`FAILED`	The charger refused or never confirmed

Locations and availability

`GET /locations`

Chargers near a point or inside a map area, with live status.

Query	Meaning
`lat`, `lng`, `radius_km`	Search around a point
`bbox`	Or a map area: `min_lng,min_lat,max_lng,max_lat`
`country`	ISO code, e.g. `MX`
`min_power_kw`	e.g. `50` for fast charging
`connector`	`CCS2`, `TYPE2`, `CHADEMO`, `GBT`…
`available_only`	`true` to hide busy or broken chargers
`updated_since`	Only locations changed since this time
`limit`, `offset`	Paging

{
  "data": [{
    "id": "LOC-CDMX-0142",
    "name": "Example Plaza, Level 2",
    "operator": { "id": "MX*EXA", "name": "Example CPO" },
    "address": "Av. Ejemplo 100, Ciudad de México",
    "coordinates": { "lat": 19.4402, "lng": -99.2038 },
    "country": "MX", "time_zone": "America/Mexico_City",
    "charge_points": [{
      "id": "MX*EXA*E0142A",
      "status": "AVAILABLE",
      "connectors": [{ "id": "1", "standard": "CCS2", "power_kw": 120, "tariff_id": "EXA-DC-PUB" }]
    }],
    "last_updated": "2026-10-01T15:04:11Z"
  }],
  "total_count": 1, "limit": 50, "offset": 0
}

`GET /locations/{id}`

One location with all its charge points, connectors, status and tariffs. Same shape as an item in GET /locations.

Errors: LOCATION_NOT_FOUND

`GET /availability`

Light status feed for keeping a map fresh without re-downloading locations.

Query	Meaning
`updated_since` required	Status changes since this time
`limit`, `offset`	Paging

{
  "data": [
    { "location_id": "LOC-CDMX-0142", "charge_point_id": "MX*EXA*E0142A",
      "status": "CHARGING", "changed_at": "2026-10-01T15:21:40Z" }
  ],
  "total_count": 1, "limit": 500, "offset": 0
}

Prices

`GET /tariffs`

Every CPO tariff on the network, as structured price components.

Query	Meaning
`updated_since`	Only tariffs changed since this time
`limit`, `offset`	Paging

{
  "data": [{
    "id": "EXA-DC-PUB",
    "currency": "MXN",
    "elements": [{
      "components": [
        { "type": "ENERGY", "price": 8.90, "unit": "kWh" },
        { "type": "FLAT",   "price": 15.00, "unit": "session" }
      ],
      "restrictions": { "start_time": "06:00", "end_time": "22:00", "day_of_week": null }
    }],
    "last_updated": "2026-09-28T10:00:00Z"
  }],
  "total_count": 38, "limit": 50, "offset": 0
}

`GET /tariffs/{id}`

One tariff. Same shape as an item in GET /tariffs.

Errors: TARIFF_NOT_FOUND

`POST /quotes`

What a charge will cost your driver at this connector, with your agreement applied.

Body field	Meaning
`location_id` required
`charge_point_id` required
`connector_id` required
`estimate.kwh`	Expected energy, e.g. `40`
`estimate.minutes`	Expected duration, for time-based prices

{
  "data": {
    "currency": "MXN",
    "pricing_mode": "PUBLIC",
    "total_incl_vat": 371.00,
    "vat": 51.17,
    "breakdown": [
      { "type": "ENERGY", "quantity": 40, "unit": "kWh", "amount": 356.00 },
      { "type": "FLAT",   "quantity": 1,  "unit": "session", "amount": 15.00 }
    ],
    "valid_until": "2026-10-01T16:00:00Z"
  }
}

Data webhooks

Event	When
`evse.status_changed`	A charge point became available, busy or out of order
`location.updated`	A location was added, changed or removed
`tariff.updated`	A CPO changed a price

Sessions

`POST /sessions`

Start charging. We send the start command to the charger.

Body field	Meaning
`order_id` required	Your order ID. Unique per partner. Same ID = same answer.
`location_id` required
`charge_point_id` required	OCPI EVSE uid
`connector_id` required
`driver_ref` required	Your stable ID for the driver

HTTP 201
{
  "data": {
    "id": "ses_7Hq2Lx",
    "order_id": "ORDER-20261001-000231",
    "status": "PENDING",
    "location_id": "LOC-CDMX-0142",
    "charge_point_id": "MX*EXA*E0142A",
    "connector_id": "1",
    "start_time": null, "end_time": null,
    "kwh": 0, "currency": "MXN", "total_cost": null,
    "created_at": "2026-10-01T15:30:02Z",
    "updated_at": "2026-10-01T15:30:02Z"
  }
}

Error	HTTP
`MISSING_FIELD`	422
`LOCATION_NOT_FOUND`	404
`CHARGE_POINT_NOT_FOUND`	404
`CONNECTOR_NOT_FOUND`	404
`CHARGE_POINT_OCCUPIED`	409
`REFERENCE_CONFLICT`	409
`REQUEST_IN_PROGRESS`	409
`SESSION_START_FAILED`	502

`GET /sessions/{id}`

One session, live: energy so far, cost so far, status. Same shape as the POST /sessions response.

Errors: SESSION_NOT_FOUND 404

`GET /sessions`

Your sessions.

Query	Meaning
`status`	`PENDING`, `ACTIVE`, `COMPLETED`, `FAILED`
`updated_since`	Only sessions changed since this time
`order_id`	Look up a session by your order ID
`limit`, `offset`	Paging

`POST /sessions/{id}/stop`

Stop charging. Returns 202 while the charger confirms.

Error	HTTP
`SESSION_NOT_FOUND`	404
`SESSION_NOT_ACTIVE`	409
`SESSION_STOP_FAILED`	502

`PUT /sessions/{id}/retail_total`

Wholesale partners only: the price you charged your driver.

Body field	Meaning
`amount` required	Incl. IVA
`currency` required

`POST /sessions/{id}/disputes`

Report a refund, chargeback or wrong charge on a session.

Body field	Meaning
`type` required	`REFUND`, `CHARGEBACK`, `BILLING_ERROR`
`amount` required	Disputed amount
`reason`
`evidence_url`

Money (read only)

`GET /receivables`

What you owe per session, and whether it has been paid.

Query	Meaning
`status`	`OPEN`, `PARTIALLY_PAID`, `PAID`, `PAID_OUT`, `DISPUTED`
`order_id`
`from`, `to`	Session end date

{
  "data": [{
    "session_id": "ses_7Hq2Lx",
    "order_id": "ORDER-20261001-000231",
    "pricing_mode": "PUBLIC",
    "gross": 371.00, "currency": "MXN",
    "your_share": 18.55, "gateway_fee": 14.47,
    "status": "PAID",
    "payin_id": "pin_20261003_0007"
  }]
}

`GET /payins`

Deposits we received from you and which sessions each one covered.

`GET /payouts`

What we paid you, when, with the SPEI tracking key.

Charging webhooks and live stream

Event	When
`session.started` · `session.updated` · `session.completed` · `session.failed`	Live session events. `session.updated` every few minutes with kWh and cost so far.
`receivable.created` · `receivable.paid` · `payout.sent`	Money events, each carrying your `order_id`

{
  "id": "evt_01J9XK2",
  "type": "session.completed",
  "created_at": "2026-10-01T16:12:44Z",
  "data": {
    "id": "ses_7Hq2Lx", "order_id": "ORDER-20261001-000231",
    "status": "COMPLETED", "kwh": 40.2,
    "total_cost": 372.78, "currency": "MXN"
  }
}

`GET /events`

Optional server-sent events stream with the same events, for live in-app screens.