List your tokens

GET

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

GET

/emsp/tokens

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.emsp.tokens.list({
        limit: 50,
        status: "ACTIVE",
        type: "RFID",
    });
}
main();

{
  "data": [
    {
      "id": 77,
      "organization_id": "550e8400-e29b-41d4-a716-446655440000",
      "uid": "04A2B3C4D5E6F7",
      "type": "RFID",
      "contract_id": "NL-OCP-C12345678-X",
      "issuer": "OCPPLab Mobility",
      "country_code": "NL",
      "party_id": "OCP",
      "whitelist": "ALLOWED",
      "ocpi_version": "221",
      "status": "ACTIVE",
      "created_at": "2026-09-30T10:00:00Z",
      "last_updated": "2026-09-30T10:00:00Z",
      "visual_number": "OCP-0001",
      "language": "nl",
      "metadata": {
        "driver_id": "drv-123"
      }
    }
  ],
  "pagination": {
    "has_next": false,
    "end_cursor": "77"
  }
}

Tokens you issued, filtered by status, type or text in uid, contract id or printed number.

Authentication

AuthorizationBearer

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

Query parameters

statusenum or nullOptional

Only this status. EXPIRED means valid_until has passed and the token is not revoked.

Allowed values:

typeenum or nullOptional

Only this OCPI token type.

Allowed values:

searchstring or nullOptional1-64 characters

Text in uid, contract id or printed number.

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

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