Get a CDR

GET

https://api.ocpplab.io/emsp/cdrs/:cdr_id

GET

/emsp/cdrs/:cdr_id

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.emsp.cdrs.get({
        cdr_id: "CDR-1",
    });
}
main();

{
  "id": "CDR-1",
  "country_code": "DE",
  "party_id": "ENA",
  "start_date_time": "2026-09-30T10:00:00Z",
  "last_updated": "2026-09-30T10:46:00Z",
  "source": "PARTNER_OCPI",
  "session_id": "SESS-1",
  "end_date_time": "2026-09-30T10:45:00Z",
  "cdr_token": {
    "uid": "DRIVER-1",
    "type": "APP_USER",
    "contract_id": "FR-EZP-C00000001-4"
  },
  "authorization_reference": "EZP-AUTH-0001",
  "cdr_location": {
    "id": "LOC-1",
    "evse_uid": "LOC-1-E1",
    "connector_id": "1"
  },
  "currency": "EUR",
  "tariffs": [
    {
      "id": "TARIFF-DC-FAST",
      "currency": "EUR"
    }
  ],
  "total_cost": {
    "excl_vat": 18.05,
    "incl_vat": 21.84
  },
  "total_energy": 30,
  "total_time": 0.75,
  "total_parking_time": 0
}

One CDR with its tariffs and totals. Send country_code and party_id when two parties used the id.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

cdr_idstringRequired1-39 characters

OCPI CDR id.

Query parameters

country_codestring or nullOptionalformat: "^[A-Z]{2}$"

Owner party’s OCPI country code; send it when two parties used the id.

party_idstring or nullOptionalformat: "^[A-Z0-9]{3}$"

Owner party’s OCPI party id; send it when two parties used the id.

Response

The CDR in OCPI 2.2.1 shape.

idstring

country_codestring

party_idstring

start_date_timedatetime

last_updateddatetime

sourceenum or any

session_idstring or nullOptional

end_date_timedatetime or nullOptional

cdr_tokenmap from strings to any or nullOptional

authorization_referencestring or nullOptional

cdr_locationmap from strings to any or nullOptional

currencystring or nullOptional

tariffslist of maps from strings to any or nullOptional

total_costmap from strings to any or nullOptional

total_energydouble or nullOptional

total_timedouble or nullOptional

total_parking_timedouble or nullOptional

Errors

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error