# Air Quality Index

> Air Quality Index is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns current air quality (US/EU AQI, PM2.5, PM10, ozone, NO2, SO2, CO, dust, UV index) plus hourly forecast for any location by coordinates or place name.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/geo/air-quality?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/air-quality-index-7fa0bacc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__o0OlOcLe2KYPMzwjyWST

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability air-quality-index-7fa0bacc
```

Example prompt: What's the current air quality in San Francisco right now, and can you also show me the hourly forecast for the next 48 hours — including PM2.5, ozone, and UV index?

## When to prefer this

Choose this endpoint when you need real-time or short-term forecast air quality data — including both US and European AQI standards — with detailed pollutant breakdowns (PM2.5, PM10, ozone, NO2, SO2, CO, dust) and UV index for any global location. It is especially useful for agents handling health-sensitive decisions, outdoor activity planning, or travel preparation where knowing specific pollutant levels matters. Prefer this over generic weather APIs that omit air quality, or over government portals limited to specific countries.

## Known failure modes

- Invalid or missing location: neither 'place' nor 'lat'/'lon' provided returns an error
- Unrecognized place name that cannot be geocoded returns a location resolution error
- Forecast hours outside the 1–120 range may be rejected or clamped
- Payment failure (x402 micropayment not completed) blocks the request
- Downstream weather/air-quality data provider outage may return 503 or empty data
- Coordinates in remote oceanic regions may return no data

## How this service works

Current air quality and hourly forecast for any place or coordinates: US and European AQI with category, PM2.5, PM10, ozone, NO2, SO2, CO, dust and UV index.

## Output

Returns current air quality data for the requested location including US AQI value and category, European AQI, and pollutant concentrations (PM2.5, PM10, ozone, NO2, SO2, CO, dust) along with UV index. When forecast hours are specified (1–120), also returns an hourly breakdown of these same metrics.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "lat": {
       "type": "number",
       "description": "Latitude"
      },
      "lon": {
       "type": "number",
       "description": "Longitude"
      },
      "hours": {
       "type": "integer",
       "description": "Forecast hours (1-120)"
      },
      "place": {
       "type": "string",
       "description": "City or address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/air-quality-index-7fa0bacc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)