Get RFIDs

Description#

This endpoint is used to get information about all RFID cards

Request format#

Method: GET

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

Response format#

The response is a Array of RFID cards, each containing the following fields:

Field name	Type	Description
active	Boolean	The RFID card is set as active in the administration dashboard.
alias	String	The RFID card name.
id	String	The unique RFID card identifier.
budget	Object	The budget of the RFID card.
budget.amount	Float	The amount of the budget of the RFID card.
type.locked	Float	Part of the amount blocked by running transactions.
lc_alias	String	The RFID card name in lower case.
infiniteOn	Object	List of chargeboxes on which the RFID ignores his budget.
infiniteOn.enabled	Boolean	If the infiniteOn feature is enabled or not.
infiniteOn.chargeboxes	Array	List 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"
},
{
        "infiniteOn": {
            "enabled": true,
            "chargeboxes": [
                "smartbit-1",
                "smartbit-2"
            ]
        },
        "alias": "Test",
        "active": true,
        "budget": {
            "amount": 47.96,
            "locked": 0
        },
        "lc_alias": "test",
        "id": "7890"
    }
]

Error response#

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

HTTP status code	Message	Description
403	APIKeyNotFound	An invalid API key was given in the header of the request.
403	RestAPINotEnabled	REST API integration is set as disabled in the administration dashboard.
403	InvalidSourceIPAddr	The request comes from an IP address that is different from the one given in the REST API integration configuration.
404	NoRFIDFound	No RFID card was found.
500	InternalServerError	Something unexpected went wrong while executing the request.