Overall AQI multi-pollutant API

Computes the overall US EPA AQI from a set of pollutant concentrations by taking the maximum sub-index and reporting the dominant pollutant, the canonical reporting rule. Answers 'What is the overall AQI given these pollutants?', 'Which pollutant is driving the AQI?'.

Price$0.06per request

MethodPOST

Route/v1/climate/aqi-overall

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

aqiair-qualityepadominant-pollutantpollutionmulti-pollutantsub-indexconcentration

API URLhttps://x402.hexl.dev/v1/climate/aqi-overall

Integration docs

Example request

{
  "concentrations": {
    "pm25": 12,
    "o3": 0.08,
    "co": 5
  }
}

Example response

{
  "aqi": 133,
  "dominantPollutant": "o3",
  "category": "Unhealthy for Sensitive Groups",
  "color": "orange",
  "subIndices": [
    {
      "pollutant": "pm25",
      "concentration": 12,
      "aqi": 56,
      "category": "Moderate"
    },
    {
      "pollutant": "o3",
      "concentration": 0.08,
      "aqi": 133,
      "category": "Unhealthy for Sensitive Groups"
    },
    {
      "pollutant": "co",
      "concentration": 5,
      "aqi": 56,
      "category": "Moderate"
    }
  ],
  "interpretation": "Overall AQI 133 (Unhealthy for Sensitive Groups), driven by O3.",
  "formula": "EPA overall AQI = max of per-pollutant sub-indices; dominant pollutant reported"
}

Input schema

{
  "type": "object",
  "required": [
    "concentrations"
  ],
  "properties": {
    "concentrations": {
      "type": "object",
      "description": "Map of pollutant (pm25/pm10/o3/co/so2/no2) to concentration",
      "examples": [
        {
          "pm25": 12,
          "o3": 0.08,
          "co": 5
        }
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}