---
title: "List Cloud Devices"
method: GET
path: "/v5/devices"
tags: ["Devices"]
---

# List Cloud Devices

`GET /v5/devices`

Retrieve a list of all cloud devices registered to the merchant with optional pagination and status information.

## Query parameters

- `limit` integer
- `offset` integer
- `include_status` 'true' | 'false'
- `include_connection_info` 'true' | 'false'
- `connection_status` 'true' | 'false'

## Response `200`

Success

- DeviceListResponse — Response containing a list of devices with pagination
  - `devices` DeviceResponse[], required — Array of device objects
    - `object` 'device', required — String representing the object's type. Always 'device' for device objects.
    - `id` string, required — Unique identifier for the device
    - `device_nickname` string, nullable — Nickname assigned to the device
    - `make` string, nullable — Device manufacturer
    - `model` string, nullable — Device model
    - `serial_number` string, nullable — Device serial number
    - `registration_status` 'registered' | 'deregistered', required — Current registration status of the device
    - `last_transaction_date` string, date-time, nullable — Date and time of the last transaction processed on this device
    - `date_registered` string, date-time, nullable — Date and time when the device was registered
    - `date_deregistered` string, date-time, nullable — Date and time when the device was deregistered
    - `connection_status` boolean, nullable — Whether the device is currently connected
    - `last_connected_date` string, date-time, nullable — Date and time when the device was last connected
    - `last_disconnected_date` string, date-time, nullable — Date and time when the device was last disconnected
    - `battery_info` object, nullable — Battery information (only included when current_status=true)
    - `wifi_info` object, nullable — WiFi information (only included when current_status=true)
  - `total_count` integer, required — Total number of devices registered to the merchant
  - `limit` integer, required — Number of devices returned per page
  - `offset` integer, required — Pagination offset
  - `has_more` boolean, required — Whether there are more devices available

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/nmi/apis/embedded-components-api.md) · [All operations](https://skmtc.net/nmi/apis/embedded-components-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nmi/embedded-components-api/versions/45c2ecda3685/schema)