MSP · CDRs
No OAuth-enabled endpoints in this section. Turn off the OAuth filter in the sidebar to see all of its endpoints.
Road enables these for your connection on request.
- Additional fieldsAdds fields OCPI 2.1.1 does not define: the owning party (country_code and party_id) on every object, and extra location data such as a publish flag, charging accessibility, parking places and the details needed for national access point reporting. Sessions and CDRs also carry VAT-inclusive totals.When not enabled: Objects carry only the fields the OCPI specification defines.
- Remapped party identitycountry_code, party_id and EVSE ids on locations, tariffs and CDRs can differ from those of the party that created them. Road rewrites them according to rules set up for the connection.When not enabled: Objects keep the identity of the party that created them.
- CDR retrieval by originNon-standard eMSP endpoint returning a CDR by its OCPI natural key triple (country_code, party_id, external id), alongside the standard retrieval by id.Available on every connection.When not enabled: Not part of the OCPI specification.
List CDR additional charges
Returns the roaming additional charges applied to CDRs.
200OCPI response envelope application/json
dataobject[]
cdrobject
locationobject
tariffsobject[]
charging_periodsobject[]
fundingobject
credit_targetobject
401Missing or invalid OCPI token
Post a CDR
Submits a charge detail record to the MSP. The Location response header carries the URL of the stored CDR.
Request bodyREQUIREDapplication/json
locationobject
coordinatesobject
nameobject
related_locationsobject[]
nameobject
evsesobject[]
status_scheduleobject[]
connectorsobject[]
coordinatesobject
directionsobject[]
imagesobject[]
parkingobject[]
registry_infoobject
directionsobject[]
operatorobject
logoobject
suboperatorobject
logoobject
ownerobject
logoobject
opening_timesobject
regular_hoursobject[]
exceptional_openingsobject[]
exceptional_closingsobject[]
imagesobject[]
energy_mixobject
energy_sourcesobject[]
environ_impactobject[]
cdr_charge_rulesobject[]
tariff_elementsobject[]
parking_placesobject[]
imagesobject[]
registry_infoobject
operator_contactobject
owner_contactobject
tariffsobject[]
tariff_alt_textobject[]
elementsobject[]
price_componentsobject[]
restrictionsobject
energy_mixobject
energy_sourcesobject[]
environ_impactobject[]
charging_periodsobject[]
dimensionsobject[]
ISO 3166-1 alpha-2 country code of the party that owns the object. Road can rewrite it according to the rules set up for the connection.
OCPI party id of the party that owns the object. Road can rewrite it according to the rules set up for the connection.
Id of the Road connection the CDR came from.
Total cost including VAT, alongside the VAT-exclusive total_cost.
fundingobject
200OCPI response envelope application/json
dataobject
locationobject
coordinatesobject
related_locationsobject[]
evsesobject[]
directionsobject[]
operatorobject
suboperatorobject
ownerobject
opening_timesobject
imagesobject[]
energy_mixobject
cdr_charge_rulesobject[]
parking_placesobject[]
registry_infoobject
tariffsobject[]
tariff_alt_textobject[]
elementsobject[]
energy_mixobject
charging_periodsobject[]
dimensionsobject[]
ISO 3166-1 alpha-2 country code of the party that owns the object. Road can rewrite it according to the rules set up for the connection.
OCPI party id of the party that owns the object. Road can rewrite it according to the rules set up for the connection.
Id of the Road connection the CDR came from.
Total cost including VAT, alongside the VAT-exclusive total_cost.
fundingobject
401Missing or invalid OCPI token
Get a CDR
Returns a single charge detail record by its id.
Path parameters1
200OCPI response envelope application/json
dataobject
locationobject
coordinatesobject
related_locationsobject[]
evsesobject[]
directionsobject[]
operatorobject
suboperatorobject
ownerobject
opening_timesobject
imagesobject[]
energy_mixobject
cdr_charge_rulesobject[]
parking_placesobject[]
registry_infoobject
tariffsobject[]
tariff_alt_textobject[]
elementsobject[]
energy_mixobject
charging_periodsobject[]
dimensionsobject[]
ISO 3166-1 alpha-2 country code of the party that owns the object. Road can rewrite it according to the rules set up for the connection.
OCPI party id of the party that owns the object. Road can rewrite it according to the rules set up for the connection.
Id of the Road connection the CDR came from.
Total cost including VAT, alongside the VAT-exclusive total_cost.
fundingobject
401Missing or invalid OCPI token
Get a CDR by origin
Returns a single charge detail record by its originating party and external id.
Path parameters3
200OCPI response envelope application/json
dataobject
locationobject
coordinatesobject
related_locationsobject[]
evsesobject[]
directionsobject[]
operatorobject
suboperatorobject
ownerobject
opening_timesobject
imagesobject[]
energy_mixobject
cdr_charge_rulesobject[]
parking_placesobject[]
registry_infoobject
tariffsobject[]
tariff_alt_textobject[]
elementsobject[]
energy_mixobject
charging_periodsobject[]
dimensionsobject[]
ISO 3166-1 alpha-2 country code of the party that owns the object. Road can rewrite it according to the rules set up for the connection.
OCPI party id of the party that owns the object. Road can rewrite it according to the rules set up for the connection.
Id of the Road connection the CDR came from.
Total cost including VAT, alongside the VAT-exclusive total_cost.