CPO · Sessions
No OAuth-enabled endpoints in this section. Turn off the OAuth filter in the sidebar to see all of its endpoints.
ROADRoad deviations in this section
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.
- Session retrieval by authorization referenceNon-standard CPO endpoint returning a session by the authorization reference issued during token authorization, resolving either the MSP or the platform authorization reference.Available on every connection.When not enabled: Not part of the OCPI specification.
GET/cpo/2.1.1/sessions
List sessions
Returns the CPO's sessions.
ROADAdditional fields
Responses
200OCPI response envelope application/json
dataobject[]
dataobject[]
idstring
start_datetimeobject
end_datetimeobject
kwhnumber <double>
auth_idstring
authorization_idstring
auth_methodstring
locationobject
locationobject
idstring
typestring
namestring
addressstring
citystring
postal_codestring
countrystring
coordinatesobject
coordinatesobject
nameobject
latitudestring
longitudestring
related_locationsobject[]
related_locationsobject[]
nameobject
latitudestring
longitudestring
evsesobject[]
evsesobject[]
uidstring
evse_idstring
statusstring
status_scheduleobject[]
capabilitiesstring[]
connectorsobject[]
floor_levelstring
coordinatesobject
physical_referencestring
directionsobject[]
parking_restrictionsstring[]
imagesobject[]
last_updatedobject
parkingobject[]
accepted_service_providersstring[]
registry_infoobject
directionsobject[]
directionsobject[]
languagestring
textstring
operatorobject
operatorobject
namestring
websitestring
logoobject
suboperatorobject
suboperatorobject
namestring
websitestring
logoobject
ownerobject
ownerobject
namestring
websitestring
logoobject
facilitiesstring[]
time_zonestring
opening_timesobject
opening_timesobject
regular_hoursobject[]
twentyfoursevenboolean
exceptional_openingsobject[]
exceptional_closingsobject[]
charging_when_closedboolean
imagesobject[]
imagesobject[]
urlstring
thumbnailstring
categorystring
typestring
widthinteger <int32>
heightinteger <int32>
energy_mixobject
energy_mixobject
is_green_energyboolean
energy_sourcesobject[]
environ_impactobject[]
supplier_namestring
energy_product_namestring
last_updatedobject
country_codestring
party_idstring
publishboolean
connection_namestring
cdr_charge_rulesobject[]
cdr_charge_rulesobject[]
idstring
labelstring
typestring
targetstring
pricestring
tariff_elementsobject[]
tariff_country_codestring
tariff_party_idstring
charging_accessibilitystring
parking_placesobject[]
parking_placesobject[]
idstring
physical_referencestring
vehicle_typesstring[]
max_vehicle_weightinteger <int32>
max_vehicle_heightinteger <int32>
max_vehicle_lengthinteger <int32>
max_vehicle_widthinteger <int32>
parking_space_lengthinteger <int32>
parking_space_widthinteger <int32>
dangerous_goods_allowedboolean
directionstring
drive_throughboolean
restricted_to_typeboolean
reservation_requiredboolean
time_limitinteger <int32>
roofedboolean
imagesobject[]
lightingboolean
refrigeration_outletboolean
standardsstring[]
apds_referencestring
help_phonestring
registry_infoobject
registry_infoobject
operator_contactobject
owner_contactobject
aggregate_power_wattsinteger <int32>
grid_voltage_levelstring
commissioned_atobject
ocpp_versionstring
smart_charging_capableboolean
ad_hoc_payment_availableboolean
ad_hoc_price_urlstring
roaming_availableboolean
roaming_hubsstring[]
payment_instrumentsstring[]
free_of_chargeboolean
parking_places_totalinteger <int32>
parking_places_disabledinteger <int32>
parking_feeboolean
green_energy_certifiedboolean
green_energy_certificatestring
meter_idstring
currencystring
charging_periodsobject[]
charging_periodsobject[]
start_date_timeobject
dimensionsobject[]
dimensionsobject[]
typestring
volumenumber <double>
total_costnumber <double>
statusstring
last_updatedobject
evse_statusstringROAD
Last known status of the EVSE the session took place on.
country_codestringROAD
ISO 3166-1 alpha-2 country code of the party that owns the object.
party_idstringROAD
OCPI party id of the party that owns the object.
authorization_referencestring
total_cost_incl_vatnumber <double>ROAD
Total cost including VAT, alongside the VAT-exclusive total_cost.
status_codeinteger
status_messagestring
timestampstring
401Missing or invalid OCPI token
No response body.