List sessions

GET

https://api.ocpplab.io/emsp/sessions

GET

/emsp/sessions

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.emsp.sessions.list({
        limit: 50,
        authorization_reference: "EZP-AUTH-0001",
    });
}
main();

{
  "data": [
    {
      "id": "SESS-1",
      "country_code": "DE",
      "party_id": "ENA",
      "start_date_time": "2026-09-30T10:00:00Z",
      "last_updated": "2026-09-30T10:20:00Z",
      "source": "PARTNER_OCPI",
      "kwh": 12.4,
      "cdr_token": {
        "uid": "DRIVER-1",
        "type": "APP_USER",
        "contract_id": "FR-EZP-C00000001-4"
      },
      "auth_method": "COMMAND",
      "authorization_reference": "EZP-AUTH-0001",
      "location_id": "LOC-1",
      "evse_uid": "LOC-1-E1",
      "connector_id": "1",
      "currency": "EUR",
      "total_cost": {
        "excl_vat": 6.15,
        "incl_vat": 7.44
      },
      "status": "ACTIVE"
    }
  ],
  "pagination": {
    "has_next": false,
    "end_cursor": "1"
  }
}

Sessions of your drivers on your own chargers and at partner CPOs, filtered by authorization, token, status or start time.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

authorization_referencestring or nullOptional<=36 characters

Only this authorization (the reference you sent the command with).

token_uidstring or nullOptional<=36 characters

Only this token uid.

statusstring or nullOptional<=20 characters

Only this OCPI status, e.g. ACTIVE.

fromdatetime or nullOptional

Only sessions started at or after this time.

todatetime or nullOptional

Only sessions started before this time.

afterstring or nullOptional1-255 characters

Cursor: the previous page’s pagination.end_cursor. Omit it for the first page.

limitintegerOptional1-200Defaults to 50

Maximum rows per page (default 50, max 200).

Response

One page of sessions.

datalist of objects

paginationobject

Spirii cursor page. Pass end_cursor as the next after value.

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error