Block, unblock, expire or relabel a token

patch/v1/tenants/{tenant_id}/tokens/{token_id}

Requires an API key

Requires tokens:write (tenant-admin). Synchronous; changes only the supplied fields, and null clears expires_at, label or external_reference. Blocked and Expired make the core refuse the card at the next authorization. The value and type are immutable. Payment flow charging tokens answer token_not_found.

Path parameters

tenant_idintegerRequired
token_idintegerRequired

Headers

idempotency-keystringRequired

Request body

statusenum | null
One of Accepted, Blocked, Expired
expires_atstring | null
ISO 8601 date-time with an offset. After it the core answers Expired; null for no expiry.
labelstring | null
Your display name for the card, for example a driver or fleet vehicle. No payment data.
1–80 characters
external_referencestring | null
Set, change or (with null) remove your identifier.
Pattern ^[A-Za-z0-9][A-Za-z0-9_.:/-]{0,127}$

Returns · 200

idintegerRequired
tenant_idintegerRequired
id_tokenstringRequired
typestring | nullRequired
statusstringRequired
Accepted, Blocked or Expired through this API; tokens written by other tools may carry another OCPP status.
expires_atstring | nullRequired
labelstring | null
external_referencestring | null
ocpp16_compatiblebooleanRequired
False when id_token is longer than the 20 characters an OCPP 1.6 idTag allows.
created_atstring | nullRequired
updated_atstring | nullRequired

Errors

401 Unauthorized 403 Forbidden 404 Not found 409 Conflict 422 Invalid request 429 Rate limited 502 Upstream error 503 Unavailable

PATCH /v1/tenants/{tenant_id}/tokens/{token_id}

curl --fail-with-body -X PATCH "https://api.ivoracharge.com/v1/tenants/1042/tokens/1" \
  -H "Authorization: Bearer $IVORA_API_KEY" \
  -H "Idempotency-Key: order-2026-09-30-0001" \
  -H "Content-Type: application/json" \
  -d '{}'

Response · 200

{
  "id": 1,
  "tenant_id": 1042,
  "id_token": "string",
  "type": "string",
  "status": "string",
  "expires_at": "2026-09-30T17:00:00Z",
  "label": "string",
  "external_reference": "property:1001",
  "ocpp16_compatible": false,
  "created_at": "2026-09-30T17:00:00Z",
  "updated_at": "2026-09-30T17:00:00Z"
}

Try it is not available here yetRequests from this page are off until the production API at https://api.ivoracharge.com is public. Use the code samples from your application server; Ivora grants production access. Keys are created in Developer tools.