Skip to main content

Get RFID

Description#

This endpoint is used to get information about a specific RFID card

Request format#

Method: GET

Endpoint: https://api.thor.tools/latest/integration/rfid/get/{id}

Response format#

The response is a JSON containing the information related to the requested RFID card with the following fields:

Field nameTypeDescription
activeBooleanThe RFID card is set as active in the administration dashboard.
aliasStringThe RFID card name.
idStringThe unique RFID card identifier.
budgetObjectThe budget of the RFID card (if null the budget is infinite).
budget.amountFloatThe amount of the budget of the RFID card.
budget.lockedFloatPart of the amount blocked by running transactions.
lc_aliasStringThe RFID card name in lower case.
infiniteOnObjectList of chargeboxes on which the RFID ignores his budget.
infiniteOn.enabledBooleanIf the infiniteOn feature is enabled or not.
infiniteOn.chargeboxesArrayList of ids of chargeboxes on which the RFID ignores the budget.

A succesful response is returned with an HTTP status code 200 - OK

Example response#

{
"alias": "Test API card",
"active": true,
"budget": {
"amount": 10,
"locked": 0
},
"lc_alias": "test api card",
"id": "3456"
}

Error response#

The following errors are returned if something went wrong while processing the request:

HTTP status codeMessageDescription
403APIKeyNotFoundAn invalid API key was given in the header of the request.
403RestAPINotEnabledREST API integration is set as disabled in the administration dashboard.
403InvalidSourceIPAddrThe request comes from an IP address that is different from the one given in the REST API integration configuration.
404NoRFIDFoundNo RFID card with the give identifier was found.
500InternalServerErrorSomething unexpected went wrong while executing the request.