Skip to content
OpenAQ Docs

Countries

The Countries resource lists countries in the OpenAQ data set and details the air quality parameters available for each. The list only includes countries that have monitoring locations from which OpenAQ ingests data, and the Country value is derived from the coordinates provided by the upstream provider. OpenAQ uses the Natural Earth 10m dataset for country boundaries, see this disclaimer. OpenAQ uses the ISO 3166-1 alpha 2 country codes, which may differ from that reported by the upstream provider.

Purpose and Use

The Countries resource helps users discover which countries are in the OpenAQ data set. It also shows the air quality metrics for each country. This makes it possible to filter and analyze air quality data by country.

Key fields

  • id - the unique identifier used within the OpenAQ system for a country
  • code - the ISO 3166-1 alpha 2 code for the country
  • name - the English name of the country

Example response payload

https://api.openaq.org/v3/countries/42

{
  "meta": {
    "name": "openaq-api",
    "website": "/",
    "page": 1,
    "limit": 100,
    "found": 1
  },
  "results": [
    {
      "id": 42,
      "code": "KZ",
      "name": "Kazakhstan",
      "datetimeFirst": "2018-07-27T17:00:00Z",
      "datetimeLast": "2024-08-31T21:07:06.731Z",
      "parameters": [
        {
          "id": 1,
          "name": "pm10",
          "units": "µg/m³",
          "displayName": null
        },
        {
          "id": 2,
          "name": "pm25",
          "units": "µg/m³",
          "displayName": null
        },
        {
          "id": 19,
          "name": "pm1",
          "units": "µg/m³",
          "displayName": null
        },
        {
          "id": 98,
          "name": "relativehumidity",
          "units": "%",
          "displayName": null
        },
        {
          "id": 100,
          "name": "temperature",
          "units": "c",
          "displayName": null
        },
        {
          "id": 125,
          "name": "um003",
          "units": "particles/cm³",
          "displayName": null
        }
      ]
    }
  ]
}