Telemetry

Get telemetry data

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.

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)
Auth
HTTP bearer

Path parameters

site_idstring required

Unique identifier of site that needs to be fetched.

Query parameters

monitoring_point_idstring required

Unique identifier of monitoring point that needs to be fetched.

aspect'NOISE' | 'DUST' | 'VIBRATION' | 'WEATHER' required

The aspect to filter monitoring points by.

start_datestring date-time required

The start date to filter results from. Must be in ISO 8601 UTC format (YYYY-MM-DDTHH:MM:SSZ). The range between start_date and end_date must be less than or equal to 1 day.

end_datestring date-time required

The end date to filter results. Must be in ISO 8601 UTC format (YYYY-MM-DDTHH:MM:SSZ). The range between start_date and end_date must be less than or equal to 1 day.

limitinteger

Maximum number of items returned in this response. (max 200)

offsetinteger

Number of items to skip. Increase by limit to fetch the next page.

Response

Default Response

Example response

{
  "data": [
    {
      "timestamp": "2025-08-11T00:15:00Z",
      "parameters": [
        {
          "name": "pm2_5mc",
          "description": "PM2.5 mass concentration, in µg/m³.",
          "value": 0.481
        }
      ]
    }
  ],
  "pagination": {
    "limit": 50,
    "hasNext": true,
    "totalItems": 100
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.