Readers
Get a Reader Status
Provides the last known status for a Reader.
This endpoint allows you to retrieve updates from the connected card reader, including the current screen being displayed during the payment process and the device status (battery level, connectivity, and update state).
Supported States
- IDLE – Reader ready for next transaction
- SELECTING_TIP – Waiting for tip input
- WAITING_FOR_CARD – Awaiting card insert/tap
- WAITING_FOR_PIN – Waiting for PIN entry
- WAITING_FOR_SIGNATURE – Waiting for customer signature
- UPDATING_FIRMWARE – Firmware update in progress
Device Status
- ONLINE – Device connected and operational
- OFFLINE – Device disconnected (last state persisted)
Note: If the target device is a Solo, it must be in version 3.3.39.0 or higher.
get/v0.1/merchants/{merchant_code}/readers/{reader_id}/status
Path parameters
merchant_codestring required
Merchant Code
reader_idstring required
The unique identifier of the Reader
Response
Response with the device status.
Example response
{
"data": {
"battery_level": 10,
"battery_temperature": 35,
"connection_type": "Wi-Fi",
"firmware_version": "3.3.3.21",
"last_activity": "2025-09-25T15:20:00Z",
"state": "IDLE",
"status": "ONLINE"
}
}