---
title: "FetchDevice"
method: GET
path: "/devices/{deviceId}"
tags: ["All Devices"]
---

# FetchDevice

`GET /devices/{deviceId}`

Fetch a device and its state.
```sh
curl $API_HOST/v1/devices/$DEVICE_ID -H "Authorization: Bearer $API_KEY"
```

## Path parameters

- `deviceId` string, required — This is the canonical device id used in the device certificate, and as the MQTT client id.

## Query parameters

- `transform` string[]

## Response `200`

Ok

- union
  - GenericDevice
    - `id` string, required — This is the canonical device id used in the device certificate, and as the MQTT client id.
    - `name` string, required — Friendly device name. Can be used for searching and filtering devices.
    - `image` string
    - `tags` DeviceTag[], required
    - `tenantId` string, required — The UUID of the team owning the device(s)
    - `subType` union, required
      - 'jitp-generic' | 'jitp-nordic-hardware' | 'unknown'
      - string
    - `firmware` DeviceFirmwareArgs
      - `supports` string[]
      - `app` object
        - `version` string
        - `name` string
      - `boot` string
      - `modem` string
      - `smpDeviceAppVer` string
    - `$meta` DeviceDocMeta, required
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `type` 'Generic', required
    - `state` GenericDeviceState
      - `reported` object
      - `desired` object
      - `delta` object
      - `metadata` object
      - `version` number, double
  - unknown

---

[API](https://skmtc.dev/nrfcloud/apis/nrf-cloud-rest-api.md) · [All operations](https://skmtc.dev/nrfcloud/apis/nrf-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nrfcloud/nrf-cloud-rest-api/revisions/c4e56e458ebf/schema)