OpenAPI reference

Receiver CDRs

POST/cdrs

Send a new CDR to the receiver. Response includes a Location header with the absolute URL to the newly created CDR. Re-POSTing an already-used `id` is always rejected with status_code 2001 (immutabili

API: OCPI 2.2.1 (eMSP) · Module: CDRs (eMSP)
Base path: /cdrs · Base URL: https://ocpi-api.gridos.co/ocpi/emsp/2.2.1

Overview

POST /cdrs

Absolute URL: https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/cdrs

Send a new CDR to the receiver. Response includes a Location header with the absolute URL to the newly created CDR. Re-POSTing an already-used id is always rejected with status_code 2001 (immutability per §3) -- including a byte-for-byte identical retry; there is no idempotent-retry short-circuit, so a client that suspects a delivery failure must GET the CDR by id to check before retrying with the same id. To correct a CDR, post a new one with credit=true and credit_reference_id pointing at the original. Self-reference and crediting an existing credit CDR are rejected.

Requires authentication. Use Authorization: Token <token>. See OCPI credentials.

How to call

Quick Shell sample (set OCPI_TOKEN when auth is required). Full Python and TypeScript under Examples.

1curl -sS -X POST 'https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/cdrs' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"country_code":"NL","party_id":"STK","id":"12345","start_date_time":"2015-06-29T21:39:09Z","end_date_time":"2015-06-29T23:37:32Z","session_id":"101","cdr_token":{"country_code":"NL","party_id":"TNM","uid":"100012","type":"RFID","contract_id":"NL-TNM-000100012"},"auth_method":"WHITELIST","cdr_location":{"id":"LOC1","name":"Gent Zuid","address":"F.Rooseveltlaan 3A","city":"Gent","postal_code":"9000","country":"BEL","coordinates":{"latitude":"51.047599","longitude":"3.729944"},"evse_uid":"3256","evse_id":"BE*BEC*E041503003","connector_id":"1","connector_standard":"IEC_62196_T2","connector_format":"SOCKET","connector_power_type":"AC_1_PHASE"},"currency":"EUR","tariffs":[{"country_code":"NL","party_id":"STK","id":"12","currency":"EUR","type":"REGULAR","elements":[{"price_components":[{"type":"TIME","price":2,"step_size":300}]}],"last_updated":"2015-02-02T14:15:01Z"}],"charging_periods":[{"start_date_time":"2015-06-29T21:39:09Z","dimensions":[{"type":"TIME","volume":1.973}],"tariff_id":"12"}],"total_cost":{"excl_vat":4},"total_energy":15.342,"total_time":1.973,"last_updated":"2015-06-29T22:01:13Z"}'

Request

Request body

application/json · Required

Schema: CDRCreate

Field	Type	Required	Description
`country_code`	`string`	Yes	—
`party_id`	`string`	Yes	—
`id`	`string`	Yes	—
`start_date_time`	`string (date-time)`	Yes	—
`end_date_time`	`string (date-time)`	Yes	—
`session_id`	`string`	No	—
`cdr_token`	`Cdr Token`	Yes	—
`auth_method`	`"AUTH_REQUEST"	"COMMAND"	"WHITELIST"`
`authorization_reference`	`string`	No	—
`cdr_location`	`Cdr Location`	Yes	—
`meter_id`	`string`	No	—
`currency`	`string`	Yes	—
`tariffs`	`object[]`	No	—
`charging_periods`	`object[]`	Yes	`Charging Periods`
`signed_data`	`object`	No	—
`total_cost`	`Total Cost`	Yes	—
`total_fixed_cost`	`object`	No	—
`total_energy`	`number`	Yes	—
`total_energy_cost`	`object`	No	—
`total_time`	`number`	Yes	—
`total_time_cost`	`object`	No	—
`total_parking_time`	`number`	No	—
`total_parking_cost`	`object`	No	—
`total_reservation_cost`	`object`	No	—
`remark`	`string`	No	—
`invoice_reference_id`	`string`	No	—
`credit`	`boolean`	No	—
`credit_reference_id`	`string`	No	—
`home_charging_compensation`	`boolean`	No	—
`last_updated`	`string (date-time)`	Yes	—

Request examples

Example 1

1{
2  "country_code": "NL",
3  "party_id": "STK",
4  "id": "12345",
5  "start_date_time": "2015-06-29T21:39:09Z",
6  "end_date_time": "2015-06-29T23:37:32Z",
7  "session_id": "101",
8  "cdr_token": {
9    "country_code": "NL",
10    "party_id": "TNM",
11    "uid": "100012",
12    "type": "RFID",
13    "contract_id": "NL-TNM-000100012"
14  },
15  "auth_method": "WHITELIST",
16  "cdr_location": {
17    "id": "LOC1",
18    "name": "Gent Zuid",
19    "address": "F.Rooseveltlaan 3A",
20    "city": "Gent",
21    "postal_code": "9000",
22    "country": "BEL",
23    "coordinates": {
24      "latitude": "51.047599",
25      "longitude": "3.729944"
26    },
27    "evse_uid": "3256",
28    "evse_id": "BE*BEC*E041503003",
29    "connector_id": "1",
30    "connector_standard": "IEC_62196_T2",
31    "connector_format": "SOCKET",
32    "connector_power_type": "AC_1_PHASE"
33  },
34  "currency": "EUR",
35  "tariffs": [
36    {
37      "country_code": "NL",
38      "party_id": "STK",
39      "id": "12",
40      "currency": "EUR",
41      "type": "REGULAR",
42      "elements": [
43        {
44          "price_components": [
45            {
46              "type": "TIME",
47              "price": 2,
48              "step_size": 300
49            }
50          ]
51        }
52      ],
53      "last_updated": "2015-02-02T14:15:01Z"
54    }
55  ],
56  "charging_periods": [
57    {
58      "start_date_time": "2015-06-29T21:39:09Z",
59      "dimensions": [
60        {
61          "type": "TIME",
62          "volume": 1.973
63        }
64      ],
65      "tariff_id": "12"
66    }
67  ],
68  "total_cost": {
69    "excl_vat": 4
70  },
71  "total_energy": 15.342,
72  "total_time": 1.973,
73  "last_updated": "2015-06-29T22:01:13Z"
74}

Example 2

1{
2  "country_code": "DE",
3  "party_id": "EMP",
4  "id": "CDR-98765",
5  "start_date_time": "2015-07-01T08:00:00Z",
6  "end_date_time": "2015-07-01T09:10:00Z",
7  "session_id": "SESSION-456",
8  "cdr_token": {
9    "country_code": "DE",
10    "party_id": "EMP",
11    "uid": "APP-22",
12    "type": "APP_USER",
13    "contract_id": "DE-EMP-C-7788"
14  },
15  "auth_method": "AUTH_REQUEST",
16  "cdr_location": {
17    "id": "LOC2",
18    "name": "Central Station Garage",
19    "address": "Stationsplein 1",
20    "city": "Utrecht",
21    "postal_code": "3511AA",
22    "country": "NLD",
23    "coordinates": {
24      "latitude": "52.089444",
25      "longitude": "5.110278"
26    },
27    "evse_uid": "EVSE-UTR-1",
28    "evse_id": "NL*STK*EUTRECHT01",
29    "connector_id": "1",
30    "connector_standard": "IEC_62196_T2",
31    "connector_format": "SOCKET",
32    "connector_power_type": "AC_3_PHASE"
33  },
34  "currency": "EUR",
35  "charging_periods": [
36    {
37      "start_date_time": "2015-07-01T08:00:00Z",
38      "dimensions": [
39        {
40          "type": "ENERGY",
41          "volume": 18.75
42        }
43      ]
44    }
45  ],
46  "total_cost": {
47    "excl_vat": 6.95
48  },
49  "total_energy": 18.75,
50  "total_time": 1.1667,
51  "last_updated": "2015-07-01T09:10:00Z"
52}

Responses

Status	Description	Schema
`201`	Successful Response	`CdrResponse`
`400`	Invalid or missing parameters (HTTP 200, OCPI envelope)	`—`
`401`	Unauthorized	`—`
`422`	Validation Error	`HTTPValidationError`

`201` — successful response

application/json

Schema: CdrResponse

Field	Type	Required	Description
`status_code`	`integer`	No	Default: `1000`
`status_message`	`string`	No	—
`timestamp`	`string (date-time)`	No	—
`data`	`CDROut`	No	`CDROut`

Response example

1{
2  "status_code": 1000,
3  "status_message": "Success",
4  "timestamp": "2024-01-15T10:00:00Z",
5  "data": {
6    "auth_method": "WHITELIST",
7    "authorization_reference": "AUTH-REF-001",
8    "cdr_location": {
9      "address": "F.Rooseveltlaan 3A",
10      "city": "Gent",
11      "connector_format": "SOCKET",
12      "connector_id": "1",
13      "connector_power_type": "AC_3_PHASE",
14      "connector_standard": "IEC_62196_T2",
15      "coordinates": {
16        "latitude": "51.04759",
17        "longitude": "3.72994"
18      },
19      "country": "BEL",
20      "evse_id": "BE-BEC-E041503001",
21      "evse_uid": "3256",
22      "id": "LOC-001",
23      "name": "Gent Zuid Parking",
24      "postal_code": "9000"
25    },
26    "cdr_token": {
27      "contract_id": "NL-TNM-012345678905880-S",
28      "country_code": "NL",
29      "party_id": "TNM",
30      "type": "RFID",
31      "uid": "012345678905880"
32    },
33    "charging_periods": [
34      {
35        "dimensions": [
36          {
37            "type": "ENERGY",
38            "volume": 15.32
39          }
40        ],
41        "start_date_time": "2024-01-15T10:00:00Z",
42        "tariff_id": "TARIFF-001"
43      }
44    ],
45    "country_code": "NL",
46    "credit": false,
47    "currency": "EUR",
48    "end_date_time": "2024-01-15T11:30:00Z",
49    "home_charging_compensation": false,
50    "id": "CDR-001",
51    "invoice_reference_id": "INV-2024-001",
52    "last_updated": "2024-01-15T11:30:00Z",
53    "meter_id": "METER-001",
54    "party_id": "CPO",
55    "remark": "Charged at Gent Zuid Parking",
56    "session_id": "SESSION-001",
57    "signed_data": {
58      "encoding_method": "OCMF",
59      "signed_values": [
60        {
61          "nature": "START",
62          "plain_data": "AP;0;3;...",
63          "signed_data": "0x1234..."
64        }
65      ]
66    },
67    "start_date_time": "2024-01-15T10:00:00Z",
68    "tariffs": [
69      {
70        "country_code": "NL",
71        "currency": "EUR",
72        "elements": [
73          {
74            "price_components": [
75              {
76                "price": 0.2,
77                "step_size": 1,
78                "type": "ENERGY",
79                "vat": 21
80              }
81            ]
82          }
83        ],
84        "id": "TARIFF-001",
85        "last_updated": "2024-01-15T10:00:00Z",
86        "party_id": "CPO"
87      }
88    ],
89    "total_cost": {
90      "excl_vat": 3.064,
91      "incl_vat": 3.7074
92    },
93    "total_energy": 15.32,
94    "total_energy_cost": {
95      "excl_vat": 3.064,
96      "incl_vat": 3.7074
97    },
98    "total_fixed_cost": {
99      "excl_vat": 0.5,
100      "incl_vat": 0.605
101    },
102    "total_parking_cost": {
103      "excl_vat": 0,
104      "incl_vat": 0
105    },
106    "total_parking_time": 0.25,
107    "total_reservation_cost": {
108      "excl_vat": 0,
109      "incl_vat": 0
110    },
111    "total_time": 1.5,
112    "total_time_cost": {
113      "excl_vat": 0,
114      "incl_vat": 0
115    }
116  }
117}

`400` — invalid or missing parameters (HTTP 200, OCPI envelope)

application/json

Response example

1{
2  "status_code": 2001,
3  "status_message": "Invalid or missing parameters",
4  "timestamp": "2025-01-01T00:00:00Z",
5  "doc_url": "https://github.com/ocpplab/ocpi-gateway/blob/main/docs/errors.md#2001-invalid-parameters",
6  "errors": [
7    {
8      "field": "country_code",
9      "message": "expected 'NL' to match Token A identity",
10      "type": "value_error.identity_mismatch"
11    }
12  ]
13}

`401` — unauthorized

application/json

Response example

1{
2  "status_code": 2001,
3  "status_message": "Unauthorized",
4  "timestamp": "2025-01-01T00:00:00Z"
5}

`422` — validation error

application/json

Schema: HTTPValidationError

Field	Type	Required	Description
`detail`	`ValidationError[]`	No	`Detail`

Response example

1{
2  "detail": [
3    {
4      "loc": [],
5      "msg": "string",
6      "type": "string",
7      "input": {
8        "_type": "Input"
9      },
10      "ctx": {
11        "_type": "Context"
12      }
13    }
14  ]
15}

Examples

Shell, Python, and TypeScript (set OCPI_TOKEN when auth is required).

1curl -sS -X POST 'https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/cdrs' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"country_code":"NL","party_id":"STK","id":"12345","start_date_time":"2015-06-29T21:39:09Z","end_date_time":"2015-06-29T23:37:32Z","session_id":"101","cdr_token":{"country_code":"NL","party_id":"TNM","uid":"100012","type":"RFID","contract_id":"NL-TNM-000100012"},"auth_method":"WHITELIST","cdr_location":{"id":"LOC1","name":"Gent Zuid","address":"F.Rooseveltlaan 3A","city":"Gent","postal_code":"9000","country":"BEL","coordinates":{"latitude":"51.047599","longitude":"3.729944"},"evse_uid":"3256","evse_id":"BE*BEC*E041503003","connector_id":"1","connector_standard":"IEC_62196_T2","connector_format":"SOCKET","connector_power_type":"AC_1_PHASE"},"currency":"EUR","tariffs":[{"country_code":"NL","party_id":"STK","id":"12","currency":"EUR","type":"REGULAR","elements":[{"price_components":[{"type":"TIME","price":2,"step_size":300}]}],"last_updated":"2015-02-02T14:15:01Z"}],"charging_periods":[{"start_date_time":"2015-06-29T21:39:09Z","dimensions":[{"type":"TIME","volume":1.973}],"tariff_id":"12"}],"total_cost":{"excl_vat":4},"total_energy":15.342,"total_time":1.973,"last_updated":"2015-06-29T22:01:13Z"}'

OpenAPI reference

Receiver CDRs

POST/cdrs

API: OCPI 2.2.1 (eMSP) · Module: CDRs (eMSP)
Base path: /cdrs · Base URL: https://ocpi-api.gridos.co/ocpi/emsp/2.2.1

Overview

POST /cdrs

Absolute URL: https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/cdrs

Requires authentication. Use Authorization: Token <token>. See OCPI credentials.

How to call

Quick Shell sample (set OCPI_TOKEN when auth is required). Full Python and TypeScript under Examples.

1curl -sS -X POST 'https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/cdrs' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"country_code":"NL","party_id":"STK","id":"12345","start_date_time":"2015-06-29T21:39:09Z","end_date_time":"2015-06-29T23:37:32Z","session_id":"101","cdr_token":{"country_code":"NL","party_id":"TNM","uid":"100012","type":"RFID","contract_id":"NL-TNM-000100012"},"auth_method":"WHITELIST","cdr_location":{"id":"LOC1","name":"Gent Zuid","address":"F.Rooseveltlaan 3A","city":"Gent","postal_code":"9000","country":"BEL","coordinates":{"latitude":"51.047599","longitude":"3.729944"},"evse_uid":"3256","evse_id":"BE*BEC*E041503003","connector_id":"1","connector_standard":"IEC_62196_T2","connector_format":"SOCKET","connector_power_type":"AC_1_PHASE"},"currency":"EUR","tariffs":[{"country_code":"NL","party_id":"STK","id":"12","currency":"EUR","type":"REGULAR","elements":[{"price_components":[{"type":"TIME","price":2,"step_size":300}]}],"last_updated":"2015-02-02T14:15:01Z"}],"charging_periods":[{"start_date_time":"2015-06-29T21:39:09Z","dimensions":[{"type":"TIME","volume":1.973}],"tariff_id":"12"}],"total_cost":{"excl_vat":4},"total_energy":15.342,"total_time":1.973,"last_updated":"2015-06-29T22:01:13Z"}'

Request

Request body

application/json · Required

Schema: CDRCreate

Field	Type	Required	Description
`country_code`	`string`	Yes	—
`party_id`	`string`	Yes	—
`id`	`string`	Yes	—
`start_date_time`	`string (date-time)`	Yes	—
`end_date_time`	`string (date-time)`	Yes	—
`session_id`	`string`	No	—
`cdr_token`	`Cdr Token`	Yes	—
`auth_method`	`"AUTH_REQUEST"	"COMMAND"	"WHITELIST"`
`authorization_reference`	`string`	No	—
`cdr_location`	`Cdr Location`	Yes	—
`meter_id`	`string`	No	—
`currency`	`string`	Yes	—
`tariffs`	`object[]`	No	—
`charging_periods`	`object[]`	Yes	`Charging Periods`
`signed_data`	`object`	No	—
`total_cost`	`Total Cost`	Yes	—
`total_fixed_cost`	`object`	No	—
`total_energy`	`number`	Yes	—
`total_energy_cost`	`object`	No	—
`total_time`	`number`	Yes	—
`total_time_cost`	`object`	No	—
`total_parking_time`	`number`	No	—
`total_parking_cost`	`object`	No	—
`total_reservation_cost`	`object`	No	—
`remark`	`string`	No	—
`invoice_reference_id`	`string`	No	—
`credit`	`boolean`	No	—
`credit_reference_id`	`string`	No	—
`home_charging_compensation`	`boolean`	No	—
`last_updated`	`string (date-time)`	Yes	—

Request examples

Example 1

1{
2  "country_code": "NL",
3  "party_id": "STK",
4  "id": "12345",
5  "start_date_time": "2015-06-29T21:39:09Z",
6  "end_date_time": "2015-06-29T23:37:32Z",
7  "session_id": "101",
8  "cdr_token": {
9    "country_code": "NL",
10    "party_id": "TNM",
11    "uid": "100012",
12    "type": "RFID",
13    "contract_id": "NL-TNM-000100012"
14  },
15  "auth_method": "WHITELIST",
16  "cdr_location": {
17    "id": "LOC1",
18    "name": "Gent Zuid",
19    "address": "F.Rooseveltlaan 3A",
20    "city": "Gent",
21    "postal_code": "9000",
22    "country": "BEL",
23    "coordinates": {
24      "latitude": "51.047599",
25      "longitude": "3.729944"
26    },
27    "evse_uid": "3256",
28    "evse_id": "BE*BEC*E041503003",
29    "connector_id": "1",
30    "connector_standard": "IEC_62196_T2",
31    "connector_format": "SOCKET",
32    "connector_power_type": "AC_1_PHASE"
33  },
34  "currency": "EUR",
35  "tariffs": [
36    {
37      "country_code": "NL",
38      "party_id": "STK",
39      "id": "12",
40      "currency": "EUR",
41      "type": "REGULAR",
42      "elements": [
43        {
44          "price_components": [
45            {
46              "type": "TIME",
47              "price": 2,
48              "step_size": 300
49            }
50          ]
51        }
52      ],
53      "last_updated": "2015-02-02T14:15:01Z"
54    }
55  ],
56  "charging_periods": [
57    {
58      "start_date_time": "2015-06-29T21:39:09Z",
59      "dimensions": [
60        {
61          "type": "TIME",
62          "volume": 1.973
63        }
64      ],
65      "tariff_id": "12"
66    }
67  ],
68  "total_cost": {
69    "excl_vat": 4
70  },
71  "total_energy": 15.342,
72  "total_time": 1.973,
73  "last_updated": "2015-06-29T22:01:13Z"
74}

Example 2

1{
2  "country_code": "DE",
3  "party_id": "EMP",
4  "id": "CDR-98765",
5  "start_date_time": "2015-07-01T08:00:00Z",
6  "end_date_time": "2015-07-01T09:10:00Z",
7  "session_id": "SESSION-456",
8  "cdr_token": {
9    "country_code": "DE",
10    "party_id": "EMP",
11    "uid": "APP-22",
12    "type": "APP_USER",
13    "contract_id": "DE-EMP-C-7788"
14  },
15  "auth_method": "AUTH_REQUEST",
16  "cdr_location": {
17    "id": "LOC2",
18    "name": "Central Station Garage",
19    "address": "Stationsplein 1",
20    "city": "Utrecht",
21    "postal_code": "3511AA",
22    "country": "NLD",
23    "coordinates": {
24      "latitude": "52.089444",
25      "longitude": "5.110278"
26    },
27    "evse_uid": "EVSE-UTR-1",
28    "evse_id": "NL*STK*EUTRECHT01",
29    "connector_id": "1",
30    "connector_standard": "IEC_62196_T2",
31    "connector_format": "SOCKET",
32    "connector_power_type": "AC_3_PHASE"
33  },
34  "currency": "EUR",
35  "charging_periods": [
36    {
37      "start_date_time": "2015-07-01T08:00:00Z",
38      "dimensions": [
39        {
40          "type": "ENERGY",
41          "volume": 18.75
42        }
43      ]
44    }
45  ],
46  "total_cost": {
47    "excl_vat": 6.95
48  },
49  "total_energy": 18.75,
50  "total_time": 1.1667,
51  "last_updated": "2015-07-01T09:10:00Z"
52}

Responses

Status	Description	Schema
`201`	Successful Response	`CdrResponse`
`400`	Invalid or missing parameters (HTTP 200, OCPI envelope)	`—`
`401`	Unauthorized	`—`
`422`	Validation Error	`HTTPValidationError`

`201` — successful response

application/json

Schema: CdrResponse

Field	Type	Required	Description
`status_code`	`integer`	No	Default: `1000`
`status_message`	`string`	No	—
`timestamp`	`string (date-time)`	No	—
`data`	`CDROut`	No	`CDROut`

Response example

1{
2  "status_code": 1000,
3  "status_message": "Success",
4  "timestamp": "2024-01-15T10:00:00Z",
5  "data": {
6    "auth_method": "WHITELIST",
7    "authorization_reference": "AUTH-REF-001",
8    "cdr_location": {
9      "address": "F.Rooseveltlaan 3A",
10      "city": "Gent",
11      "connector_format": "SOCKET",
12      "connector_id": "1",
13      "connector_power_type": "AC_3_PHASE",
14      "connector_standard": "IEC_62196_T2",
15      "coordinates": {
16        "latitude": "51.04759",
17        "longitude": "3.72994"
18      },
19      "country": "BEL",
20      "evse_id": "BE-BEC-E041503001",
21      "evse_uid": "3256",
22      "id": "LOC-001",
23      "name": "Gent Zuid Parking",
24      "postal_code": "9000"
25    },
26    "cdr_token": {
27      "contract_id": "NL-TNM-012345678905880-S",
28      "country_code": "NL",
29      "party_id": "TNM",
30      "type": "RFID",
31      "uid": "012345678905880"
32    },
33    "charging_periods": [
34      {
35        "dimensions": [
36          {
37            "type": "ENERGY",
38            "volume": 15.32
39          }
40        ],
41        "start_date_time": "2024-01-15T10:00:00Z",
42        "tariff_id": "TARIFF-001"
43      }
44    ],
45    "country_code": "NL",
46    "credit": false,
47    "currency": "EUR",
48    "end_date_time": "2024-01-15T11:30:00Z",
49    "home_charging_compensation": false,
50    "id": "CDR-001",
51    "invoice_reference_id": "INV-2024-001",
52    "last_updated": "2024-01-15T11:30:00Z",
53    "meter_id": "METER-001",
54    "party_id": "CPO",
55    "remark": "Charged at Gent Zuid Parking",
56    "session_id": "SESSION-001",
57    "signed_data": {
58      "encoding_method": "OCMF",
59      "signed_values": [
60        {
61          "nature": "START",
62          "plain_data": "AP;0;3;...",
63          "signed_data": "0x1234..."
64        }
65      ]
66    },
67    "start_date_time": "2024-01-15T10:00:00Z",
68    "tariffs": [
69      {
70        "country_code": "NL",
71        "currency": "EUR",
72        "elements": [
73          {
74            "price_components": [
75              {
76                "price": 0.2,
77                "step_size": 1,
78                "type": "ENERGY",
79                "vat": 21
80              }
81            ]
82          }
83        ],
84        "id": "TARIFF-001",
85        "last_updated": "2024-01-15T10:00:00Z",
86        "party_id": "CPO"
87      }
88    ],
89    "total_cost": {
90      "excl_vat": 3.064,
91      "incl_vat": 3.7074
92    },
93    "total_energy": 15.32,
94    "total_energy_cost": {
95      "excl_vat": 3.064,
96      "incl_vat": 3.7074
97    },
98    "total_fixed_cost": {
99      "excl_vat": 0.5,
100      "incl_vat": 0.605
101    },
102    "total_parking_cost": {
103      "excl_vat": 0,
104      "incl_vat": 0
105    },
106    "total_parking_time": 0.25,
107    "total_reservation_cost": {
108      "excl_vat": 0,
109      "incl_vat": 0
110    },
111    "total_time": 1.5,
112    "total_time_cost": {
113      "excl_vat": 0,
114      "incl_vat": 0
115    }
116  }
117}

`400` — invalid or missing parameters (HTTP 200, OCPI envelope)

application/json

Response example

1{
2  "status_code": 2001,
3  "status_message": "Invalid or missing parameters",
4  "timestamp": "2025-01-01T00:00:00Z",
5  "doc_url": "https://github.com/ocpplab/ocpi-gateway/blob/main/docs/errors.md#2001-invalid-parameters",
6  "errors": [
7    {
8      "field": "country_code",
9      "message": "expected 'NL' to match Token A identity",
10      "type": "value_error.identity_mismatch"
11    }
12  ]
13}

`401` — unauthorized

application/json

Response example

1{
2  "status_code": 2001,
3  "status_message": "Unauthorized",
4  "timestamp": "2025-01-01T00:00:00Z"
5}

`422` — validation error

application/json

Schema: HTTPValidationError

Field	Type	Required	Description
`detail`	`ValidationError[]`	No	`Detail`

Response example

1{
2  "detail": [
3    {
4      "loc": [],
5      "msg": "string",
6      "type": "string",
7      "input": {
8        "_type": "Input"
9      },
10      "ctx": {
11        "_type": "Context"
12      }
13    }
14  ]
15}

Examples

Shell, Python, and TypeScript (set OCPI_TOKEN when auth is required).

1curl -sS -X POST 'https://ocpi-api.gridos.co/ocpi/emsp/2.2.1/cdrs' \
2  -H "Authorization: Token $OCPI_TOKEN" \
3  -H 'Content-Type: application/json' \
4  -d '{"country_code":"NL","party_id":"STK","id":"12345","start_date_time":"2015-06-29T21:39:09Z","end_date_time":"2015-06-29T23:37:32Z","session_id":"101","cdr_token":{"country_code":"NL","party_id":"TNM","uid":"100012","type":"RFID","contract_id":"NL-TNM-000100012"},"auth_method":"WHITELIST","cdr_location":{"id":"LOC1","name":"Gent Zuid","address":"F.Rooseveltlaan 3A","city":"Gent","postal_code":"9000","country":"BEL","coordinates":{"latitude":"51.047599","longitude":"3.729944"},"evse_uid":"3256","evse_id":"BE*BEC*E041503003","connector_id":"1","connector_standard":"IEC_62196_T2","connector_format":"SOCKET","connector_power_type":"AC_1_PHASE"},"currency":"EUR","tariffs":[{"country_code":"NL","party_id":"STK","id":"12","currency":"EUR","type":"REGULAR","elements":[{"price_components":[{"type":"TIME","price":2,"step_size":300}]}],"last_updated":"2015-02-02T14:15:01Z"}],"charging_periods":[{"start_date_time":"2015-06-29T21:39:09Z","dimensions":[{"type":"TIME","volume":1.973}],"tariff_id":"12"}],"total_cost":{"excl_vat":4},"total_energy":15.342,"total_time":1.973,"last_updated":"2015-06-29T22:01:13Z"}'

Receiver CDRs

Overview

How to call

Request

Request body

Request examples

Responses

`201` — successful response

`400` — invalid or missing parameters (HTTP 200, OCPI envelope)

`401` — unauthorized

`422` — validation error

Examples

Is this helpful?

AI Tools

On this page

Receiver CDRs

Overview

How to call

Request

Request body

Request examples

Responses

`201` — successful response

`400` — invalid or missing parameters (HTTP 200, OCPI envelope)

`401` — unauthorized

`422` — validation error

Examples

Is this helpful?

AI Tools

On this page