List a charge point's CDRs

GET

https://api.ocpplab.io/cpo/charge-points/:charge_point_id/cdrs

GET

/cpo/charge-points/:charge_point_id/cdrs

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.cpo.chargePoints.listCdrs({
        charge_point_id: "CP-AMS-001",
        date_from: new Date("2026-09-30T00:00:00Z"),
        date_to: new Date("2026-10-01T00:00:00Z"),
        limit: 50,
        offset: 0,
    });
}
main();

{
  "items": [
    {
      "id": 4001,
      "cdr_id": "CDR-2026-09-30-0001",
      "start_date_time": "2026-09-30T08:00:00Z",
      "end_date_time": "2026-09-30T09:15:00Z",
      "cdr_token": {
        "uid": "04A2B3C4D5E6F7",
        "country_code": "NL",
        "party_id": "OCP",
        "type": "RFID",
        "contract_id": "NL-OCP-C12345678-X"
      },
      "auth_method": "WHITELIST",
      "cdr_location": {
        "id": "LOC-AMS-01",
        "name": "Amsterdam depot",
        "evse_uid": "NL*OCP*E1001*1",
        "evse_id": "NL*OCP*E1001*1",
        "connector_id": "1",
        "connector_standard": "IEC_62196_T2",
        "connector_format": "SOCKET",
        "connector_power_type": "AC_3_PHASE"
      },
      "currency": "EUR",
      "charging_periods": [
        {
          "start_date_time": "2026-09-30T08:00:00Z",
          "dimensions": [
            {
              "type": "ENERGY",
              "volume": "22.5"
            }
          ]
        }
      ],
      "total_cost": {
        "excl_vat": "9.20",
        "incl_vat": "11.13"
      },
      "total_energy": "22.5",
      "total_time": "1.25",
      "last_updated": "2026-09-30T09:15:00Z",
      "role": "CPO",
      "origin": "LOCAL",
      "organization_id": "550e8400-e29b-41d4-a716-446655440000",
      "country_code": "NL",
      "party_id": "OCP",
      "ocpi_version": "2.2.1",
      "created_at": "2026-09-30T09:15:00Z",
      "updated_at": "2026-09-30T09:15:00Z",
      "session_id": "S-2026-09-30-0001",
      "location_id": "LOC-AMS-01",
      "evse_uid": "NL*OCP*E1001*1",
      "connector_id": "1",
      "charge_point_id": "CP-AMS-001"
    }
  ],
  "offset": 0,
  "limit": 50
}

CDRs of sessions on the charger, newest start first, optionally within a time window. 404 if the charger does not exist.

Authentication

AuthorizationBearer

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

Path parameters

charge_point_idstringRequired1-36 characters

The charger's OCPP identity.

Query parameters

date_fromdatetime or nullOptional

Only rows starting at or after this time (inclusive).

date_todatetime or nullOptional

Only rows starting before this time (exclusive).

offsetintegerOptional>=0Defaults to 0

Rows to skip. Pass the previous page’s next_offset to continue.

limitintegerOptional1-200Defaults to 50

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

Response

One page of results; next_offset is null on the last page.

itemslist of objects

offsetinteger

limitinteger

next_offsetinteger or nullOptional

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error