Get a command

GET

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

GET

/emsp/commands/:tracking_id

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.emsp.commands.get({
        tracking_id: "6f1c2b0e-3c4d-4e5f-8a9b-0c1d2e3f4a5b",
    });
}
main();

{
  "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"
}

Route, status, the immediate response and the final result of one command. A roaming command still PENDING is refreshed from the partner’s CommandResult first, so polling this finishes it.

Authentication

AuthorizationBearer

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

Path parameters

tracking_idstringRequiredformat: "^[\x21-\x7e]+$"1-36 characters

tracking_id returned by POST /emsp/commands/....

Response

The command with its route, response and final result.

tracking_idstring

commandenum or any

authorization_referencestring

routeobject

statusenum or any

created_atdatetime

expires_atdatetime

responseobject or nullOptional

The CPO’s / charger’s immediate OCPI CommandResponse.

resultstring or nullOptional

session_idstring or nullOptional

responded_atdatetime or nullOptional

finished_atdatetime or nullOptional

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error