Create a CDR

POST

https://api.ocpplab.io/ocpi/cpo/:version/cdrs

POST

/ocpi/cpo/:version/cdrs

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.ocpi.cpoData.createCdr({
        version: "221",
        body: {
            id: "CDR-20260930-0001",
            start_date_time: "2026-09-30T08:00:00Z",
            end_date_time: "2026-09-30T10:00:00Z",
            session_id: "SES-20260930-0001",
            cdr_token: {
                country_code: "DE",
                party_id: "EMS",
                uid: "04A2B3C4D5E6F7",
                type: "RFID",
                contract_id: "DE-EMS-C12345678-X",
            },
            auth_method: "WHITELIST",
            cdr_location: {
                id: "LOC-AMS-1",
                address: "Stationsplein 1",
                city: "Amsterdam",
                country: "NLD",
                coordinates: {
                    latitude: "52.379189",
                    longitude: "4.899431",
                },
                evse_uid: "EVSE-AMS-1-1",
                evse_id: "NL*OCP*E0001*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,
                        },
                    ],
                },
            ],
            total_cost: {
                before_taxes: 7.7,
                taxes: [
                    {
                        name: "VAT",
                        amount: 1.62,
                    },
                ],
            },
            total_energy: 22,
            total_time: 2,
            last_updated: "2026-09-30T10:00:00Z",
        },
    });
}
main();

{
  "cdr_id": "CDR-20260930-0001",
  "created": true
}

Stores a CDR (charge detail record), the billed record of a finished session. CDRs cannot be changed once created. Pass push_to_partner_id to also push it to that partner right away.

Authentication

AuthorizationBearer

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

Path parameters

versionenumRequired

OCPI version: 211 (2.1.1), 221 (2.2.1) or 230 (2.3.0).

Allowed values:

Query parameters

push_to_partner_idinteger or nullOptional>=1

Also push the written object to this roaming partner right away.

Request

This endpoint expects a map from strings to any.

Response

Successful Response

cdr_idstring

createdbooleanOptionalDefaults to true

pushobject or nullOptional

Outcome of pushing one object to a roaming partner.

Errors

400

Bad Request Error

401

Unauthorized Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error