---
title: "List devices for one app or fetch one device by `device_id`."
method: GET
path: "/device/"
tags: ["devices"]
---

# List devices for one app or fetch one device by \`device_id\`.

`GET /device/`

## Request

- Base URL: `https://api.capgo.app`
- URL: `https://api.capgo.app/device/`
- Auth: API key in header `x-api-key`

List devices for one app or fetch a single device by `device_id`, including the current bundle and channel override.

## Query parameters

- `app_id` string, required
- `device_id` string
- `cursor` string
- `limit` integer

## Response `200`

Device data.

- union
  - DeviceEnvelope
    - `device_id` string, required
    - `custom_id` string, nullable
    - `version` integer, nullable
    - `version_name` string, nullable
    - `channel` string, nullable
    - `app_id` string, required
    - `platform` 'ios' | 'android' | 'electron', required
    - `plugin_version` string, nullable
    - `os_version` string, nullable
    - `version_build` string, nullable
    - `is_prod` boolean
    - `is_emulator` boolean
    - `key_id` string, nullable
    - `updated_at` string, date-time
  - DeviceListEnvelope
    - `data` Device[], required
      - `device_id` string, required
      - `custom_id` string, nullable
      - `version` integer, nullable
      - `version_name` string, nullable
      - `channel` string, nullable
      - `app_id` string, required
      - `platform` 'ios' | 'android' | 'electron', required
      - `plugin_version` string, nullable
      - `os_version` string, nullable
      - `version_build` string, nullable
      - `is_prod` boolean
      - `is_emulator` boolean
      - `key_id` string, nullable
      - `updated_at` string, date-time
    - `nextCursor` string
    - `hasMore` boolean

## Other responses

- `401`: The API key is missing, invalid, or expired.
- `403`: The API key is valid but lacks the required scope or org access.
- `429`: Too many requests. Back off and retry later.
- `500`: Unexpected Capgo server error.

---

[API](https://skmtc.dev/capgo/apis/capgo-public-api.md) · [All operations](https://skmtc.dev/capgo/apis/capgo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/capgo/apis/capgo-public-api/revisions/8496acb7a95b?raw)