---
title: "Get device by ID"
method: GET
path: "/api/v1/devices/{deviceId}"
tags: ["Devices"]
---

# Get device by ID

`GET /api/v1/devices/{deviceId}`

Get information about a single device. Alternative is to call 'Get all devices' with a `deviceId` filter query parameter.

## Path parameters

- `deviceId` string, uuid, required

## Response `200`

Information about a single device.

- Device
  - `id` string
  - `types` string[]
  - `name` string
  - `metadata` DeviceMetadata
    - `status` object — Unix timestamp in nanoseconds.
      - `value` 'OFFLINE' | 'ONLINE'
      - `validUntil` string, int64
    - `shadowSynchronization` 'UNSET' | 'ENABLED' | 'DISABLED'
  - `manufacturerName` object[]
    - `language` string
    - `value` string
  - `modelNumber` string
  - `interfaces` string[]
  - `protocolIndependentId` string

## Other responses

- `400` — Bad Request
- `401` — Not authorized
- `404` — Entity was not found.

## Changes

- **2021-07-27** `4d121732b593` — 3 warning, 11 info
  - removed the optional property `device` from the response with the `200` status
  - removed the optional property `links` from the response with the `200` status
  - removed the optional property `status` from the response with the `200` status
  - added the media type `application/json` for the response with the status `401`
  - …10 more
- **2021-03-12** `91690cbfa230` — 1 warning
  - deleted the `header` request parameter `Correlation-ID`
- **2020-08-19** `53ff7bcf1a4f` — 2 breaking
  - the `device` response's property type changed from no type to `object` for status `200`
  - the `links` response's property type changed from no type to `object` for status `200`
- **2020-08-17** `66b5ddf2a001` — 1 info
  - endpoint added
- **2020-04-11** `562192db9767` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/plgd-dev/apis/plgd-http-gateway/changes/api/v1/devices/:deviceId/get.md)

---

[API](https://skmtc.dev/plgd-dev/apis/plgd-http-gateway.md) · [All operations](https://skmtc.dev/plgd-dev/apis/plgd-http-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plgd-dev/plgd-http-gateway/revisions/daf228bd321e/schema)