Session

No OAuth-enabled endpoints in this section. Turn off the OAuth filter in the sidebar to see all of its endpoints.

No Road deviations in this section. Turn off the deviations filter in the sidebar to see all of its endpoints.

POST/sessions

Start Session

Request
Header parameters1
Idempotency-Keystring
Request bodyREQUIREDapplication/json
chargePointIdstring
referencestring
Responses
201Successfully returns the charging session object with complete details including status, timing, and billing information. application/json
createdAtstring <date-time>
updatedAtstring <date-time>
startedAtstring <date-time>
currencystring
deletedAtstring <date-time>
referencestring
stoppedAtstring <date-time>
settlementVersioninteger <int32>
kwhnumber <double>
costnumber <double>
statestring
stateChangesobject[]
changedAtstring <date-time>
reasonstring
statestring
idstring
sessionIdstring
idstring
integrationIdstring
chargePointIdstring
authorizationReferencestring
400Bad Request - The request was unacceptable, often due to missing or invalid parameters. Response follows RFC 7807 Problem Details format with structured error information. application/json
titlestring
statusinteger
detailstring
reasonstring
metaobject
500Internal Server Error - Something went wrong on our end. These errors are rare and typically indicate a temporary issue with our servers. Response follows RFC 7807 Problem Details format. May include 'Retry-After' header for transient errors. application/json
titlestring
statusinteger
detailstring
reasonstring
metaobject
GET/sessions/list

List Sessions

Request
Query parameters2
limitinteger <int64>
default 50
offsetinteger <int64>
default 0
Responses
200Successfully returns a paginated list of charging sessions in reverse chronological order. Includes pagination metadata with total count, current page, offset, and limit. application/json
metadataobject
totalinteger <int64>
pageinteger <int64>
offsetinteger <int64>
limitinteger <int64>
sessionsobject[]
createdAtstring <date-time>
updatedAtstring <date-time>
startedAtstring <date-time>
currencystring
deletedAtstring <date-time>
referencestring
stoppedAtstring <date-time>
settlementVersioninteger <int32>
kwhnumber <double>
costnumber <double>
statestring
stateChangesobject[]
changedAtstring <date-time>
reasonstring
statestring
idstring
sessionIdstring
idstring
integrationIdstring
chargePointIdstring
authorizationReferencestring
400Bad Request - The request was unacceptable, often due to missing or invalid parameters. Response follows RFC 7807 Problem Details format with structured error information. application/json
titlestring
statusinteger
detailstring
reasonstring
metaobject
500Internal Server Error - Something went wrong on our end. These errors are rare and typically indicate a temporary issue with our servers. Response follows RFC 7807 Problem Details format. May include 'Retry-After' header for transient errors. application/json
titlestring
statusinteger
detailstring
reasonstring
metaobject
GET/sessions/{sessionId}

Get Session

Request
Path parameters1
sessionIdstring <uuid>REQUIRED
Responses
200Successfully returns the charging session object with complete details including status, timing, and billing information. application/json
createdAtstring <date-time>
updatedAtstring <date-time>
startedAtstring <date-time>
currencystring
deletedAtstring <date-time>
referencestring
stoppedAtstring <date-time>
settlementVersioninteger <int32>
kwhnumber <double>
costnumber <double>
statestring
stateChangesobject[]
changedAtstring <date-time>
reasonstring
statestring
idstring
sessionIdstring
idstring
integrationIdstring
chargePointIdstring
authorizationReferencestring
400Bad Request - The request was unacceptable, often due to missing or invalid parameters. Response follows RFC 7807 Problem Details format with structured error information. application/json
titlestring
statusinteger
detailstring
reasonstring
metaobject
404Not Found - The requested resource does not exist. This could be due to an incorrect ID, or the resource may have been deleted. Response follows RFC 7807 Problem Details format. application/json
titlestring
statusinteger
detailstring
reasonstring
metaobject
500Internal Server Error - Something went wrong on our end. These errors are rare and typically indicate a temporary issue with our servers. Response follows RFC 7807 Problem Details format. May include 'Retry-After' header for transient errors. application/json
titlestring
statusinteger
detailstring
reasonstring
metaobject
POST/sessions/{sessionId}/stop

Stop Session

Request
Path parameters1
sessionIdstring <uuid>REQUIRED
Header parameters1
Idempotency-Keystring
Responses
202Accepted
No response body.
400Bad Request - The request was unacceptable, often due to missing or invalid parameters. Response follows RFC 7807 Problem Details format with structured error information. application/json
titlestring
statusinteger
detailstring
reasonstring
metaobject
404Not Found - The requested resource does not exist. This could be due to an incorrect ID, or the resource may have been deleted. Response follows RFC 7807 Problem Details format. application/json
titlestring
statusinteger
detailstring
reasonstring
metaobject
500Internal Server Error - Something went wrong on our end. These errors are rare and typically indicate a temporary issue with our servers. Response follows RFC 7807 Problem Details format. May include 'Retry-After' header for transient errors. application/json
titlestring
statusinteger
detailstring
reasonstring
metaobject