---
title: "Get device information"
method: GET
path: "/sites/{site_id}/devices/{device_id}"
tags: ["Devices"]
---

# Get device information

`GET /sites/{site_id}/devices/{device_id}`

## Request

- Base URL: `https://api.sitehive.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sitehive.co/sites/{site_id}/devices/{device_id}`
- Auth: HTTP bearer

Returns information about a specific device identified by its `device_id`

## Path parameters

- `site_id` string, required
- `device_id` string, required

## Response `200`

A device that can be assigned to monitoring points to collect measurements.

- Def1: A device that can be assigned to monitoring points to collect measurements.
  - `id` string, required: Unique identifier for the device.
  - `serial` string, required: Serial number of the device.
  - `type` 'SITEHIVE' | 'THIRD_PARTY', required: The type of device.
  - `capabilities` string[], required: List of measurement aspects that the device can record.
  - `calibrationAt` string, date, required: ISO 8601 date when the device was last calibrated.
  - `calibrationDueAt` string, date, required: ISO 8601 date when the device calibration is due.
  - `monitoringPointAssignments` object[], required: List of monitoring points where the device has been assigned, with assignment periods. If the device is currently unassigned, this array will be empty.
    - `id` string, required: Unique identifier for the monitoring point.
    - `name` string, required: Name of the monitoring point.
    - `startDate` string, date-time, required: ISO 8601 UTC timestamp marking when the device assignment started.
    - `endDate` string, date-time, required: ISO 8601 UTC timestamp marking when the device assignment ended. Null if still active.

## Other responses

- `401`: Returned when a request attempts to access a protected resource without providing authentication credentials.
- `403`: Returned when an authenticated request is denied due to insufficient permissions or access rights.
- `404`: Returned when a requested resource does not exist or cannot be located.

---

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