Get Charge Detail Records
x-ms-visibility: "important"
Retrieves all Charge Detail Records (CDRs).
Query Parameters
Page to be fetched. Default: 1
Limit (No. of records per page). Max value: 100. Default: 100.
Start timestamp for the period to be fetched. Default: 7 days ago.
End timestamp for the period to be fetched. Default: Now.
Filter by specific session IDs. Comma-separated list of session IDs.
Filter by specific transaction IDs. Comma-separated list of transaction IDs.
Filter by specific integration IDs. Comma-separated list of integration IDs.
Filter by specific charger IDs. Comma-separated list of charger IDs.
Filter by specific socket IDs. Comma-separated list of socket IDs.
Filter by specific statuses. Comma-separated list of statuses.
Free text filter for integration name and other details.
Field to be used for sorting. Default: integrationName
Set to 'true' to sort descending based on sort key. Default: 'false'
- 200
- 400
- 401
- 500
Charge Detail Records successfully retrieved.
Schema
- Array [
- Array [
- ]
- ]
items object[]
Possible values: [AD_HOC_USER, APP_USER, OTHER, RFID]
Default value: AD_HOC_USER
tariffs object[]
Possible values: [AD_HOC_PAYMENT, PROFILE_CHEAP, PROFILE_FAST, PROFILE_GREEN, REGULAR]
Default value: AD_HOC_PAYMENT
financialAdviceConfirmation object
totalCosts object
Possible values: [SUCCESS, PARTIAL_SUCCESS, FAILED]
Default value: SUCCESS
{
"page": 0,
"limit": 0,
"totalRecords": 0,
"hasNextPage": true,
"hasPreviousPage": true,
"items": [
{
"sessionId": "string",
"transactionId": "string",
"status": "string",
"integrationId": "string",
"startDateTime": "2025-09-04T07:11:42.216Z",
"endDateTime": "2025-09-04T07:11:42.216Z",
"lastUpdated": "2025-09-04T07:11:42.216Z",
"consumptionKWH": 0,
"chargerId": "string",
"chargerName": "string",
"evseUid": "string",
"evseId": "string",
"socketId": 0,
"socketName": "string",
"address": "string",
"city": "string",
"country": "string",
"postalCode": "string",
"cdrTokenUid": "string",
"cdrTokenType": "AD_HOC_USER",
"contractId": "string",
"authorizationReference": "string",
"totalCostInclVat": 0,
"totalCostExclVat": 0,
"totalFixedCostInclVat": 0,
"totalFixedCostExclVat": 0,
"totalEnergyCostInclVat": 0,
"totalEnergyCostExclVat": 0,
"totalTimeCostInclVat": 0,
"totalTimeCostExclVat": 0,
"totalParkingTimeCostInclVat": 0,
"totalParkingTimeCostExclVat": 0,
"totalTime": "string",
"serviceProviderId": "string",
"infraProviderId": "string",
"tariffs": [
{
"externalId": "string",
"type": "AD_HOC_PAYMENT",
"currency": "string"
}
],
"financialAdviceConfirmation": {
"id": "string",
"authorizationReference": "string",
"totalCosts": {
"exclVat": 0,
"inclVat": 0
},
"currency": "string",
"eftData": [
"string"
],
"captureStatusCode": "SUCCESS",
"captureStatusMessage": "string",
"lastUpdated": "2025-09-04T07:11:42.216Z"
}
}
]
}
Details of the validation error.
Schema
extensions object
{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"extensions": {}
}
User not authorized.
An unexpected error occurred.
Schema
{
"errorCode": "string",
"message": "string",
"errorNumber": 0,
"helpLink": "string"
}