---
title: "Retrieve a list of cash drawers"
method: GET
path: "/v1/device/cash-drawers"
tags: ["DEVICE"]
---

# Retrieve a list of cash drawers

`GET /v1/device/cash-drawers`

Retrieve a list of the device's connected cash drawers. Discovery of a cash drawer only indicates that it is either connected now, or there is an available hardware port allowing one to be connected. For example, local RJ12-type cash drawers may or may not actually be connected at the time this operation is invoked but will be returned regardless. Other types of cash drawers (e.g. USB cash drawers) may only be discovered if they are physically connected at the time of the call.

## Headers

- `User-Agent` string, required
- `X-Clover-Device-Id` string, required
- `X-POS-Id` string, required
- `X-Clover-Timeout` integer

## Response `200`

A response from a Clover device containing a list of cash drawers supported at this time by this device.

- CashDrawersResponse
  - `drawers` CashDrawer[]
    - `id` string — String which uniquely identifies a cash drawer
    - `name` string
    - `number` integer — The drawer number, starting at 1.

## Other responses

- `209` — Operation was canceled.
- `400` — The request is invalid, and subsequent calls will continue to fail; do not repeat the call.
- `401` — An invalid bearer token has been provided. The call may be repeated if the provided bearer token is updated.
- `415` — The request is invalid, and contains request data in an unsupported format. This call may be repeated if the content is changed to a supported format.
- `500` — The request processing failed with an unknown error, and the processing state of the operation is indeterminate. Do not repeat the call without additional analysis.
- `501` — The device does not have the ability to respond to the requested operation; do not repeat the call.
- `503` — The device is not available because it is currently servicing another call. This can be repeated at a later time, or cancel may be called to end the current operation.
- `504` — The Device did not respond in a timely manner. This can be repeated at a later time.

---

[API](https://skmtc.net/clover/apis/platform-api.md) · [All operations](https://skmtc.net/clover/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clover/platform-api/versions/08da265101a3/schema)