List callback deliveries

GET

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

GET

/emsp/callbacks

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

{
  "data": [
    {
      "callback_id": "0b7f4c1e-2d3a-4e5f-9a8b-7c6d5e4f3a2b",
      "kind": "command",
      "authorization_reference": "EZP-AUTH-0001",
      "method": "POST",
      "url": "https://api.easyplug.example/hooks/command",
      "status": "delivered",
      "attempts": 1,
      "created_at": "2026-09-30T10:00:09Z",
      "tracking_id": "6f1c2b0e-3c4d-4e5f-8a9b-0c1d2e3f4a5b",
      "response_status": 200,
      "delivered_at": "2026-09-30T10:00:10Z"
    }
  ],
  "pagination": {
    "has_next": false,
    "end_cursor": "1"
  }
}

Command, session and CDR callbacks sent to the URLs from your command headers: attempts, last error and status. Send authorization_reference or tracking_id.

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

tracking_idstring or nullOptional<=36 characters

Only this command's callbacks.

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 callback deliveries.

datalist of objects

paginationobject

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

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error