---
title: "Get telemetry data"
method: GET
path: "/sites/{site_id}/telemetry"
tags: ["Telemetry"]
---

# Get telemetry data

`GET /sites/{site_id}/telemetry`

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

Returns telemetry records for a monitoring point, ordered by timestamp. Paginated with limit and offset; pagination.totalItems gives the total record count.

Each record holds the parameters measured for the requested aspect. A parameter is omitted from a record when the device did not report it.

### NOISE

| Parameter | Unit | Description |
|---|---|---|
| `laeq` | dB | A-weighted equivalent continuous sound level over the record interval (LAeq), in dB. |
| `lan10` | dB | A-weighted sound level exceeded for 10% of the record interval (LA10), in dB. |
| `lan90` | dB | A-weighted sound level exceeded for 90% of the record interval (LA90), in dB. |
| `laMax` | dB | Maximum A-weighted sound level in the record interval (LAmax), in dB. |
| `laMin` | dB | Minimum A-weighted sound level in the record interval (LAmin), in dB. |

### DUST

| Parameter | Unit | Description |
|---|---|---|
| `pm2_5mc` | µg/m³ | PM2.5 mass concentration, in µg/m³. |
| `pm10mc` | µg/m³ | PM10 mass concentration, in µg/m³. |

### VIBRATION

| Parameter | Unit | Description |
|---|---|---|
| `xAccVDV^4` | (m/s^1.75)^4 | Fourth power of the X-axis vibration dose value for the record period, in (m/s^1.75)^4. Sum these values across records and take the fourth root to get the VDV. |
| `yAccVDV^4` | (m/s^1.75)^4 | Fourth power of the Y-axis vibration dose value for the record period, in (m/s^1.75)^4. Sum these values across records and take the fourth root to get the VDV. |
| `zAccVDV^4` | (m/s^1.75)^4 | Fourth power of the Z-axis vibration dose value for the record period, in (m/s^1.75)^4. Sum these values across records and take the fourth root to get the VDV. |
| `vdvPeriod` | seconds | Length of the period the VDV values cover, in seconds. |
| `xPeak` | mm/s | Peak particle velocity on the X axis, in mm/s. |
| `yPeak` | mm/s | Peak particle velocity on the Y axis, in mm/s. |
| `zPeak` | mm/s | Peak particle velocity on the Z axis, in mm/s. |
| `xFreq` | Hz | Dominant frequency on the X axis, in Hz. |
| `yFreq` | Hz | Dominant frequency on the Y axis, in Hz. |
| `zFreq` | Hz | Dominant frequency on the Z axis, in Hz. |
| `vSum` | mm/s | Peak vector sum of the X, Y and Z particle velocities, in mm/s. |

### WEATHER

| Parameter | Unit | Description |
|---|---|---|
| `rainfall` | mm | Rainfall during the record interval, in mm. |
| `windSpeedMax` | km/h | Maximum wind speed over the record interval, in km/h. |
| `windSpeedMin` | km/h | Minimum wind speed over the record interval, in km/h. |
| `windSpeedAvg` | km/h | Average wind speed over the record interval, in km/h. |
| `windDirection` | degrees | Wind direction, in degrees clockwise from north. |
| `temperatureMax` | °C | Maximum air temperature over the record interval, in °C. |
| `temperatureMin` | °C | Minimum air temperature over the record interval, in °C. |
| `temperatureAvg` | °C | Average air temperature over the record interval, in °C. |
| `humidityMax` | % | Maximum relative humidity over the record interval, in %. |
| `humidityMin` | % | Minimum relative humidity over the record interval, in %. |
| `humidityAvg` | % | Average relative humidity over the record interval, in %. |
| `pressureMax` | hPa | Maximum barometric pressure over the record interval, in hPa. Only reported by weather stations that measure pressure. |
| `pressureMin` | hPa | Minimum barometric pressure over the record interval, in hPa. Only reported by weather stations that measure pressure. |
| `pressureAvg` | hPa | Average barometric pressure over the record interval, in hPa. Only reported by weather stations that measure pressure. |
| `dewPoint` | °C | Dew point, in °C. |

## Path parameters

- `site_id` string, required

## Query parameters

- `monitoring_point_id` string, required
- `aspect` 'NOISE' | 'DUST' | 'VIBRATION' | 'WEATHER', required
- `start_date` string, date-time, required
- `end_date` string, date-time, required
- `limit` integer
- `offset` integer

## Response `200`

Default Response

- object
  - `data` Def9[], required
    - `timestamp` string, date-time, required: ISO 8601 UTC timestamp indicating when the telemetry was recorded.
    - `parameters` object[], required: List of measured parameters for this telemetry record.
      - `name` string, required: Name of the measured parameter. The parameters available for each aspect are listed in the telemetry endpoint description.
      - `description` string, required: What the parameter measures, including its unit.
      - `value` number, required: Value of the measured parameter.
  - `pagination` Def6, required: Pagination information including the total number of items available.
    - `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.
    - `totalItems` integer, required: Total number of items across all pages.

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