Get charging session​

GET
/sessions/{chargingSessionId}

Returns the session lifecycle, authorization method, meter readings, and any available pricing or billing data. A user whose userId matches the session owner can view that session even when standard permission checks would deny access.

Use cases

  • Show the current state and energy totals for a session.
  • Retrieve the session ID before requesting meter data.

Related endpoints

  • GET /sessions — find sessions using filters.
  • GET /sessions/{chargingSessionId}/meter-data — retrieve detailed meter readings.
  • POST /sessions/{chargingSessionId}/stop — stop an in-progress session.

Authorizations​

bearerAuth

Generate an API token here

Type
HTTP (bearer)

Parameters​

Header Parameters

compatibility-date*

API compatibility date in YYYY-MM-DD format. Must be a date after 2025-11-01.

Type
string
Required
Example"2025-11-02"
Pattern
^\d{4}-\d{2}-\d{2}$
organization-id*

Routes the request to the organization named by this ID. The bearer token must be authorized for that organization.

Type
string
Required
Example"3b241101-e2bb-4255-8caf-4136c566a962"
Min Length
1
Max Length
40

Path Parameters

chargingSessionId*

ID returned by POST /sessions/start or GET /sessions. Use it to retrieve meter readings or stop that session.

Type
string
Required
Example"3ABCDEFGHJKLMNPQRSTU"
Min Length
1
Max Length
40

Responses​

success.chargingSession.get

application/json

Playground​

Authorization
Headers
Variables
Key
Value

Samples​