---
title: "Get a Reader Status"
method: GET
path: "/v0.1/merchants/{merchant_code}/readers/{reader_id}/status"
tags: ["Readers"]
---

# Get a Reader Status

`GET /v0.1/merchants/{merchant_code}/readers/{reader_id}/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.

## Path parameters

- `merchant_code` string, required
- `reader_id` string, required

## Response `200`

Response with the device status.

- StatusResponse — Status of a device
  - `data` object, required
    - `battery_level` number, float — Battery level percentage
    - `battery_temperature` integer — Battery temperature in Celsius
    - `connection_type` 'btle' | 'edge' | 'gprs' | 'lte' | 'umts' | 'usb' | 'Wi-Fi' — Type of connection used by the device
    - `firmware_version` string — Firmware version of the device
    - `last_activity` string, date-time — Timestamp of the last activity from the device
    - `state` 'IDLE' | 'SELECTING_TIP' | 'WAITING_FOR_CARD' | 'WAITING_FOR_PIN' | 'WAITING_FOR_SIGNATURE' | 'UPDATING_FIRMWARE' — Latest state of the device
    - `status` 'ONLINE' | 'OFFLINE', required — Status of a device

## Other responses

- `400` — Response when given params (or one of them) are invalid
- `401` — Response when given merchant's token is invalid
- `404` — Response when given reader is not found

## Changes

- **2026-03-11** `cd79d83b07e0` — 1 breaking, 7 info
  - the response property `errors/type` became optional for the status `401`
  - added the media type `application/problem+json` for the response with the status `400`
  - added the media type `application/problem+json` for the response with the status `401`
  - added the media type `application/problem+json` for the response with the status `404`
  - …4 more
- **2026-02-25** `bef1083e0580` — 3 warning
  - deleted the `header` request parameter `Accept`
  - deleted the `header` request parameter `Authorization`
  - deleted the `header` request parameter `Content-Type`
- **2025-12-20** `ebe39fb0eb0b` — 1 breaking
  - the `data/battery_level` response's property type/format changed from `float`/`` to `number`/`float` for status `200`
- **2025-12-19** `bdda188d36dd` — 1 breaking
  - the `data` response's property type/format changed from ``/`` to `object`/`` for status `200`
- **2025-12-18** `132e5091a885` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sumup/apis/sumup-rest-api/changes/v0.1/merchants/:merchant_code/readers/:reader_id/status/get.md)

---

[API](https://skmtc.dev/sumup/apis/sumup-rest-api.md) · [All operations](https://skmtc.dev/sumup/apis/sumup-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sumup/sumup-rest-api/revisions/b050b86c35d1/schema)