Skip to main content
GET
List sessions

Authorizations

x-api-key
string
header
required

API key issued during onboarding. Every request must supply a valid x-api-key header.

Query Parameters

limit
string
default:100

Maximum number of items to return. Missing, non-integer, zero, or negative values use the default of 100. Values above 100 are clamped to 100.

offset
string
default:0

Zero-based index of the first item to return. Missing, non-integer, or negative values use 0.

stationId
string

Filter sessions to a station public identifier. Must be exactly 8 alphanumeric characters (a-zA-Z0-9); any other value returns 400.

Pattern: ^[a-zA-Z0-9]{8}$
chargerId
string

Filter sessions to a charger public identifier. Must be exactly 8 alphanumeric characters (a-zA-Z0-9); any other value returns 400.

Pattern: ^[a-zA-Z0-9]{8}$
connectorId
integer

Filter sessions to a 1-based connector number. Non-integer values and values below 1 return 400.

Required range: x >= 1
customerId
string

Filter sessions to a customer identifier supplied by the partner system.

Minimum string length: 1
auth_reference
string

Filter sessions by the optional auth_reference supplied to POST /sessions/start.

Minimum string length: 1
status
enum<string>

Filter sessions by lifecycle status. Case-insensitive; any other value returns 400.

Available options:
ACTIVE,
COMPLETED

Response

Session list.

data
object[]
required