---
title: "List devices"
method: GET
path: "/devices"
tags: ["product:chat"]
---

# List devices

`GET /devices`

Returns all available devices

## Query parameters

- `user_id` string — **Server-side only**. User ID which server acts upon

## Response `200`

ListDevicesResponse

- ListDevicesResponse, nullable — List devices response
  - `devices` DeviceResponse[], required — List of devices
    - `created_at` string, date-time, required — Date/time of creation
    - `disabled` boolean — Whether device is disabled or not
    - `disabled_reason` string — Reason explaining why device had been disabled
    - `hardware_id` string — Stable physical device identifier used to deduplicate pushes across push providers
    - `id` string, required — Device ID
    - `push_provider` string, required — Push provider
    - `push_provider_name` string — Push provider name
    - `user_id` string, required — User ID
    - `voip` boolean — When true the token is for Apple VoIP push notifications
  - `duration` string, required

## Other responses

- `400` — Bad request
- `429` — Too many requests

## Changes

- **2026-07-29** `d274674f0337` — 1 info
  - added the optional property `devices/items/hardware_id` to the response with the `200` status

[Change history](https://skmtc.dev/getstream/apis/stream-api/changes/devices/get.md)

---

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