List CDRs

GET

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

GET

/emsp/cdrs

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.emsp.cdrs.list({
        limit: 50,
        session_id: "SESS-1",
    });
}
main();

{
  "data": [
    {
      "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
    }
  ],
  "pagination": {
    "has_next": false,
    "end_cursor": "1"
  }
}

Charge detail records of your drivers, filtered by authorization, session, token or start time.

Authentication

AuthorizationBearer

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

Query parameters

authorization_referencestring or nullOptional<=36 characters

Only this authorization (the reference you sent the command with).

session_idstring or nullOptional<=36 characters

Only CDRs of this session.

token_uidstring or nullOptional<=36 characters

Only this token uid.

fromdatetime or nullOptional

Only CDRs of sessions started at or after this time.

todatetime or nullOptional

Only CDRs of sessions started before this time.

afterstring or nullOptional1-255 characters

Cursor: the previous page’s pagination.end_cursor. Omit it for the first page.

limitintegerOptional1-200Defaults to 50

Maximum rows per page (default 50, max 200).

Response

One page of CDRs.

datalist of objects

paginationobject

Spirii cursor page. Pass end_cursor as the next after value.

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error