Provision a token

POST

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

POST

/emsp/tokens

import { OcpplabSDK } from "ocpplab";
async function main() {
    const client = new OcpplabSDK({
        token: "YOUR_TOKEN_HERE",
    });
    await client.emsp.tokens.provision({
        idempotencyKey: "5d1f7c2e-8b3a-4e6f-9c0d-1a2b3c4d5e6f",
        body: {
            uid: "04A2B3C4D5E6F7",
            type: "RFID",
            contract_id: "NL-OCP-C12345678-X",
            issuer: "OCPPLab Mobility",
            visual_number: "OCP-0001",
            language: "nl",
            metadata: {
                driver_id: "drv-123",
            },
            auto_activate: true,
        },
    });
}
main();

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

Creates the token as PROVISIONED; with auto_activate it is pushed to roaming partners and stored ACTIVE. If the push to roaming partners fails the call answers 502 and the token is left as it was; retry with the same Idempotency-Key.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

uidstringRequired1-36 characters

typeenumRequired

Allowed values:

contract_idstringRequired1-36 characters

issuerstringRequired1-64 characters

visual_numberstring or nullOptional<=64 characters

group_idstring or nullOptional<=36 characters

whitelistenum or nullOptionalDefaults to ALLOWED

Allowed values:

languagestring or nullOptionalformat: "^[a-z]{2}$"

valid_fromdatetime or nullOptional

valid_untildatetime or nullOptional

country_codestring or nullOptionalformat: "^[A-Z]{2}$"

party_idstring or nullOptionalformat: "^[A-Z0-9]{3}$"

ocpi_versionenum or nullOptionalDefaults to 221

Allowed values:

metadatamap from strings to any or nullOptional

auto_activateboolean or nullOptionalDefaults to false

Response

The token; ACTIVE when auto_activate was set, else PROVISIONED.

idinteger

organization_idstring

uidstring

typeenum or any

contract_idstring

issuerstring

country_codestring

party_idstring

whitelistenum or any

ocpi_versionstring

statusenum or any

created_atdatetime

last_updateddatetime

visual_numberstring or nullOptional

group_idstring or nullOptional

languagestring or nullOptional

valid_fromdatetime or nullOptional

valid_untildatetime or nullOptional

metadatamap from strings to any or nullOptional

status_reasonstring or nullOptional

invalidated_atdatetime or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

502

Bad Gateway Error

504

Gateway Timeout Error

Authentication

Headers

Request

Response

Errors