Get a session's CDR

GET

https://api.ocpplab.io/cpo/sessions/:session_id/cdr

GET

/cpo/sessions/:session_id/cdr

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.cpo.sessions.getCdr({
        session_id: "S-2026-09-30-0001",
    });
}
main();

{
  "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"
}

The CDR that billed the session. 404 if the session does not exist or has no CDR yet.

Authentication

AuthorizationBearer

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

Path parameters

session_idstringRequired1-36 characters

OCPI session id.

Query parameters

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

Only this OCPI party country code, e.g. NL.

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

Only this OCPI party id, e.g. OCP.

Response

The requested object.

idinteger

cdr_idstring

start_date_timedatetime

end_date_timedatetime

cdr_tokenobject

Token snapshot stored on a session or CDR. Older rows may only have a uid. The other OCPI fields are null until the processor stored them.

auth_methodenum or any

cdr_locationobject

Location snapshot billed on a CDR.

currencystring

charging_periodslist of objects

total_costobject

total_energystring

total_timestring

last_updateddatetime

rolestring

originenum or any

organization_idstring

country_codestring

party_idstring

ocpi_versionstring

created_atdatetime

updated_atdatetime

session_idstring or nullOptional

authorization_referencestring or nullOptional

meter_idstring or nullOptional

tariffslist of objects or nullOptional

signed_dataobject or nullOptional

Signed meter data attached to a CDR.

total_fixed_costobject or nullOptional

total_energy_costobject or nullOptional

total_time_costobject or nullOptional

total_parking_timestring or nullOptional

total_parking_costobject or nullOptional

total_reservation_costobject or nullOptional

remarkstring or nullOptional

invoice_reference_idstring or nullOptional

creditboolean or nullOptional

credit_reference_idstring or nullOptional

home_charging_compensationboolean or nullOptional

location_idstring or nullOptional

evse_uidstring or nullOptional

connector_idstring or nullOptional

charge_point_idstring or nullOptional

booking_idstring or nullOptional

receiver_cdr_urlstring 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