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

# Get devices

`GET /sites/{site_id}/devices`

## 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`
- Auth: HTTP bearer

Returns a list of all devices for a given site available to the authenticated user.

## Path parameters

- `site_id` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Default Response

- object
  - `data` Def1[], required
    - `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.
  - `pagination` Def5, required: Basic pagination information for a list response.
    - `offset` integer, required: The starting index of the returned items in the full dataset.
    - `limit` integer, required: Maximum number of items returned in this response.
    - `hasNext` boolean, required: True if another page is available, false on the last page.

## 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.

---

[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)