---
title: "Get device list"
method: GET
path: "/devices"
tags: ["Device"]
---

# Get device list

`GET /devices`

## Query parameters

- `page` integer
- `pageSize` integer

## Headers

- `x-device-ap` string

## Response `200`

Device list

- GetDeviceListResponse
  - `data` DeviceInfo[], required — List of devices
    - `deviceId` string, required — Device ID
    - `status` string, required — Device status
    - `enable` string, required — Device enable status
    - `providerType` string, required — Provider type
    - `productModel` string, required — Product model from ro.product.model
    - `providerId` string, required — Provider ID
    - `isIdle` boolean, required — Whether device is idle
  - `total` number, required — Total number of devices
  - `message` string, required — Response message

## Changes

- **2025-10-15** `cea48a6d14d1` — 1 info
  - the `header` request parameter `x-device-ap` became optional
- **2025-10-11** `959a2717174a` — 1 breaking, 3 info
  - added the new required `header` request parameter `x-device-ap`
  - api operation id `DeviceController_getDeviceList` removed and replaced with `DeviceController_list`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `pageSize`

[Change history](https://skmtc.dev/babelcloud/apis/gbox-open-api/changes/devices/get.md)

---

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