Skip to navigation
ProxyTokens

Get an authorization token by idTag

The idTag / IdToken a charger log shows, matched like Authorize: exact id_token_type, then untyped, then any type.

Authentication

AuthorizationBearer

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

Path parameters

id_tokenstringRequired1-36 characters

Query parameters

id_token_typestring or nullOptional1-50 characters
include_deletedbooleanOptionalDefaults to false

Include soft-deleted tokens.

Response

Successful Response
idinteger
Token id on the gateway.
id_tokenstring
RFID UID or idTag the charger sends.
statusstring

Authorization status, e.g. Accepted or Blocked.

id_token_typestring or nullOptional

OCPP 2.x IdTokenType, e.g. ISO14443.

cache_expiry_date_timedatetime or nullOptional
When chargers must stop trusting a cached authorization.
parent_id_tagstring or nullOptional

OCPP parentIdTag: the token group the token belongs to.

prepaid_balancestring or nullOptional
Remaining prepaid balance, as a decimal string.
real_time_authbooleanOptionalDefaults to false
True when every use must be authorized online.
provider_idinteger or nullOptional
Issuing provider id on the gateway.
descriptionstring or nullOptional

Free-text notes.

deleted_atdatetime or nullOptional

When the token was soft-deleted.

card_numberstring or nullOptional
Number printed on the card.
card_stateenumOptionalDefaults to Active

Card issuance state; Unused cards are refused by Authorize.

Allowed values:
valid_untildatetime or nullOptional

Card validity; past it Authorize answers Expired.

allow_simultaneous_chargingbooleanOptionalDefaults to true
Whether this card may authorize another charge while it has an active transaction.
status_reasonstring or nullOptional
Why the status last changed, e.g. a block reason.
status_changed_atdatetime or nullOptional
When the status last changed.
revisionintegerOptionalDefaults to 1

Increases on every change; pass as expected_revision to guard writes.

Errors

401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
502
Bad Gateway Error
504
Gateway Timeout Error