Back
Tokens
Overview
Tokens represent driver identification — RFID cards, app-based auth, or ad-hoc payment. EMSPs push token data to CPOs so drivers can be authorized at any charge point in the roaming network.
Who sends
EMSP (E-Mobility Service Provider)
Who receives
CPO (Charge Point Operator)
Key Fields
| Field | Type | Description |
|---|---|---|
uid | CiString(36) | Unique token identifier (e.g. RFID UID) |
type | TokenType | RFID, APP_USER, or OTHER |
auth_id | CiString(36) | Contract ID for this driver |
valid | boolean | Whether the token is currently valid |
whitelist | WhitelistType | ALWAYS, ALLOWED, ALLOWED_OFFLINE, or NEVER |
Endpoints
GET
/ocpi/2.2.1/tokens/
PUT
/ocpi/2.2.1/tokens/{country_code}/{party_id}/{token_uid}
POST
/ocpi/2.2.1/tokens/{token_uid}/authorize
Live Endpoint Tester
Send requests directly to the local backend and see the response.
GET