List commands

GET

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

GET

/emsp/commands

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

{
  "data": [
    {
      "tracking_id": "6f1c2b0e-3c4d-4e5f-8a9b-0c1d2e3f4a5b",
      "command": "START_SESSION",
      "authorization_reference": "EZP-AUTH-0001",
      "route": {
        "kind": "roaming",
        "location": {
          "country_code": "DE",
          "party_id": "ENA",
          "location_id": "LOC-1"
        },
        "evse_uid": "LOC-1-E1",
        "connector_id": "1",
        "partner_id": 21,
        "ocpi_version": "2.2.1",
        "cpo_id": "DE*ENA"
      },
      "status": "ACCEPTED",
      "created_at": "2026-09-30T10:00:00Z",
      "expires_at": "2026-09-30T10:01:00Z",
      "response": {
        "result": "ACCEPTED",
        "timeout": 30
      },
      "result": "ACCEPTED",
      "session_id": "SESS-1",
      "responded_at": "2026-09-30T10:00:01Z",
      "finished_at": "2026-09-30T10:00:09Z"
    }
  ],
  "pagination": {
    "has_next": false,
    "end_cursor": "1"
  }
}

Commands you sent, oldest first, optionally for one authorization.

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).

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 commands, oldest first.

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