Skip to main content

Monitor Details

Fetches the full profile for one monitor — this is what fills the detail panel when a user clicks a pin on the map.


Get a single monitor​

GET /api/v2/devices/network-coverage/monitors/{monitorId}?token={SECRET_TOKEN}

Path parameters

ParameterDescription
monitorIdThe id of a monitor, from the summary or country-monitors response

Query parameters

ParameterTypeDescription
tokenstringRequired
tenantstringOptional. Defaults to airqo.

Example

curl "https://api.airqo.net/api/v2/devices/network-coverage/monitors/66f4a2b3c4d5e6f7a8b9c0d2?token={SECRET_TOKEN}"

Example response

{
"success": true,
"message": "Successfully retrieved monitor",
"monitor": {
"id": "66f4a2b3c4d5e6f7a8b9c0d2",
"name": "US Embassy Kampala",
"city": "Kampala",
"country": "Uganda",
"countryId": "uganda",
"iso2": "UG",
"latitude": 0.3123,
"longitude": 32.5811,
"type": "Reference",
"status": "active",
"lastActive": "2025-09-28T07:30:00.000Z",
"network": "us-embassy",
"operator": "US Department of State",
"equipment": "BAM 1022",
"manufacturer": "Met One Instruments",
"pollutants": ["PM2.5"],
"resolution": "Hourly",
"transmission": "Fiber",
"site": "US Embassy compound",
"landUse": "Institutional",
"deployed": "2019-03-01",
"calibrationLastDate": "",
"calibrationMethod": "",
"uptime30d": "",
"publicData": "Yes",
"organisation": "US Department of State",
"coLocation": "Not available",
"coLocationNote": "",
"viewDataUrl": "https://airnow.gov"
}
}

This particular monitor happens to be a reference instrument contributed by another operator, not an AirQo device — the shape of the response is identical either way, which is the point: your client code doesn't need to special-case who runs a monitor.

Monitor fields

FieldTypeDescription
idstringMonitor identifier
namestringMonitor / site name
city, country, countryId, iso2stringLocation context — countryId matches the id used in Monitors & Countries
latitude, longitudenumberCoordinates used to place the pin
typeReference | LCS | InactiveHardware category
statusactive | inactiveCurrent operational status
lastActivestring (ISO date)Last time the monitor reported data
networkstringThe operating network — matches a value in meta.availableNetworks from the summary endpoint
operator, organisationstringWho runs the monitor
equipment, manufacturerstringHardware details
pollutantsstring[]Pollutants measured, e.g. ["PM2.5", "PM10"]
resolutionstringSampling/reporting frequency, e.g. "Hourly"
transmissionstringHow data reaches the server, e.g. "GSM"
site, landUsestringPhysical site description
deployedstringDeployment date
calibrationLastDate, calibrationMethodstringCalibration history
uptime30dstringRolling 30-day uptime, e.g. "96%"
publicDataYes | NoWhether this monitor's readings are publicly viewable
coLocation, coLocationNotestringCo-location details, if any
viewDataUrlstringLink to view this monitor's live data, when publicData is Yes
Coordinate approximation

Like the rest of the API, coordinates for AirQo-owned sites are subject to the ~0.5 km privacy approximation. Monitors contributed by other operators via the community registry are not adjusted.


Next steps​