Skip to main content

Impact Statistics

Returns the aggregate numbers behind the map — total monitors, breakdowns by type/status/manufacturer, and estimated population reached. This is what powers the reference page's headline stats.

Get impact summary​

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

Query parameters

ParameterTypeDescription
tokenstringRequired
tenantstringOptional. Defaults to airqo.
activeOnlybooleanOptional. Restrict all counts to active monitors.
typesstringOptional. Comma-separated: Reference, LCS.
networkstringOptional. Comma-separated network names.

Example

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

Example response

{
  "success": true,
  "message": "Impact summary retrieved successfully",
  "impact": {
    "totalMonitors": 1840,
    "byType": { "Reference": 62, "LCS": 1712, "Inactive": 66 },
    "byStatus": { "active": 1774, "inactive": 66 },
    "totalCities": 128,
    "totalCountries": 30,
    "totalPopulationReached": 84500000,
    "citiesWithPopulationData": 46,
    "byCountry": [
      {
        "country": "Uganda",
        "iso2": "UG",
        "population": 45700000,
        "total": 142,
        "Reference": 4,
        "LCS": 138,
        "active": 136,
        "inactive": 6
      }
    ],
    "byCity": [
      {
        "city": "Kampala",
        "country": "Uganda",
        "iso2": "UG",
        "population": 1680000,
        "total": 58,
        "Reference": 2,
        "LCS": 56,
        "active": 55,
        "inactive": 3
      }
    ],
    "bySensorManufacturer": [
      {
        "sensorManufacturer": "AirQo",
        "totalMonitors": 1600,
        "byType": { "Reference": 0, "LCS": 1560, "Inactive": 40 },
        "byStatus": { "active": 1560, "inactive": 40 },
        "totalCities": 90,
        "totalCountries": 22,
        "totalPopulationReached": 60000000,
        "citiesWithPopulationData": 38,
        "byCountry": [],
        "byCity": []
      }
    ],
    "generatedAt": "2025-09-28T09:00:00.000Z"
  }
}

Response fields

FieldDescription
totalMonitors, byType, byStatusGlobal counts across all matched monitors
totalCities, totalCountriesDistinct cities/countries with at least one monitor
totalPopulationReachedSum of population figures (from City Population Data) for every city with a monitor — null where population data isn't available for enough cities to compute a meaningful figure
citiesWithPopulationDataHow many of totalCities have a known population — use this alongside totalPopulationReached to gauge coverage of the population estimate itself
byCountry[], byCity[]Per-country / per-city breakdowns with the same shape as the top-level counts, plus population
bySensorManufacturer[]The same full breakdown, scoped to each manufacturer — lets you answer "how much of the network does manufacturer X cover?"
Population figures are estimates

totalPopulationReached reflects a monitor being present somewhere in a city, not real coverage radius or air-quality representativeness across that city's full population. Treat it as a headline number, not a scientific exposure estimate.

Next steps​