---
title: "Read Devices item"
method: GET
path: "/api/devices/{deviceId}"
tags: ["Devices"]
---

# Read Devices item

`GET /api/devices/{deviceId}`

*threadDevice* item in the *Devices* collection selected by its `id`.

## Condition
Requires a *threadDevice* item with the given `id` to exist;
otherwise returns 404 Not Found.

## Path parameters

- `deviceId` string, required — Alphanumeric hex string of length 16

## Query parameters

- `fields` object
  - `type` string[]

## Headers

- `Accept` 'application/json' | 'application/vnd.api+json'

## Response `200`

(JSON:API) document with a single `data` object representing the selected *threadDevice* item.

- union
  - object[]
  - object

## Other responses

- `400` — The client sent an invalid request. The client SHOULD perform action(s) to provide valid syntax before retrying the request.
- `404` — The client requested a target resource that does not exist. The client SHOULD perform action(s) to re-align with the API or re-synchronize application state before retrying the request.
- `406` — The client requests a content-type that is not supported by the target resource. The client SHOULD perform action(s) to re-align with the API before retrying the request.

---

[API](https://skmtc.net/openthread/apis/swagger-openthread-rest-api.md) · [All operations](https://skmtc.net/openthread/apis/swagger-openthread-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openthread/swagger-openthread-rest-api/versions/a62dd7e2debc/schema)