Indoor Air API Guide

AirGradient ONE: API Access and Data Export

The AirGradient ONE (I-9PSL) is a Wi-Fi indoor monitor that you can read directly on your own network as well as through AirGradient’s cloud dashboard and API. It suits small projects and technically comfortable buyers who want current readings without depending on a vendor account. The central tradeoff: the local endpoint returns only current values, so history either comes from the cloud API (in limited windows) or from your own logging.

Best fit and when it may not suit you

Good fit

May be unsuitable

What this profile covers

Hardware
AirGradient ONE indoor monitor, model I-9PSL (9th generation); cellular variant I-9PSL-CE listed separately
Platform
Direct local HTTP access on the monitor, plus the AirGradient Dashboard and its cloud API
Plan
No named paid plan found. The product page calls the dashboard subscription-free; the same page lists 12 months of dashboard and API access for the assembled unit (see discrepancies).
Scope
Consumer and small projects. Sold to individuals, schools and small organizations. Nothing reviewed describes an enterprise contract, SLA or fleet-management tier.

Capabilities apply to this setup only. Other AirGradient products may differ.

AirGradient measurements and units

Parameters reported by AirGradient ONE
ParameterTypeUnitModelsNotes
CO2MeasuredppmI-9PSLSenseAir S8 NDIR sensor (0–10,000 ppm per spec); reported as rco2. [1, 4]
PM1, PM2.5, PM10Measuredµg/m³I-9PSLPlantower PMS5003 laser scattering sensor. The cloud API also exposes a corrected PM2.5 field. [1, 3]
TVOCIndex (relative)VOC Index (0–500)I-9PSLSensirion SGP41. The vendor describes it as relative change, not a concentration. A raw signal is also exposed locally; the spec mentions a ppb option without detail. [1, 4]
NOxIndex (relative)NOx Index (0–500)I-9PSL [1, 4]
Temperature, relative humidityMeasured°C, %RHI-9PSLSpec table names Sensirion SHT40; page narrative says SHT3x/4x. [1]

Requirements

Monitor
Available AirGradient ONE I-9PSL, sold assembled or as a kit with the same hardware. [1]
Gateway or hub
Not applicable No gateway is described; the monitor connects over Wi-Fi itself. [1]
Network
Available 2.4 GHz Wi-Fi (802.11 b/g/n). A cellular model, I-9PSL-CE, is listed as an alternative. Condition: A 5 V / 2 A USB power supply is required and not included. [1]
Account
Conditional Not needed for the local endpoint. The cloud API token comes from an AirGradient Dashboard account. [2, 3]
Subscription
Unknown The product page says the dashboard is subscription-free; the same page lists “12 months” of dashboard and API access. What applies after 12 months is not stated. [1]

Local access, cloud API and export

In practice there are two separate paths. On your own network, any script can request the monitor’s current readings as JSON without an account, as long as the firmware is recent enough. That is ideal for a dashboard on a wall or a home-automation system, but nothing is stored unless you store it.

The cloud path runs through AirGradient’s dashboard. Once API access is enabled for a place, a token lets you request current values and history in windows of up to 10 days. MQTT and Home Assistant are further options that push or pull readings locally. Opting in to the public map is a separate choice and is not needed for any of these.

Local access

Conditional HTTP GET /measures/current on the monitor’s local hostname returns current readings as JSON; /config reads and writes settings. No dashboard token is needed. Condition: Firmware 3.0.10 or later; client on the same network. [2, 4]

Cloud API

Conditional REST API at api.airgradient.com with current, past (5- or 60-minute buckets) and raw-measure endpoints per location. Condition: API access must be enabled in dashboard settings to obtain a token. The assembled unit lists 12 months of dashboard and API access; terms after that are not stated. [2, 3]

Manual export

Not publicly documented No dashboard CSV export procedure was found in the documentation reviewed. [2, 1]

Other protocols

Available MQTT (broker URL in local config), native Home Assistant support (2024.6+ with current firmware), Homey; community ESPHome, Prometheus and openHAB integrations. A Modbus specification article is listed but was not reviewed. [1, 4]

AirGradient API details

Authentication
Available Cloud: per-place access token passed as a “token” query parameter. Local: no authentication is documented. [3, 4]
Who can access which data
Available The token is issued for a place and returns that place’s private data. Some world/public endpoints need no token and return only data owners chose to share. The public indoor dataset is opt-in, and indoor coordinates are rounded to one decimal place before publication. [3, 2, 5]
Latest versus historical data
Conditional Local endpoint: current values only. Cloud: current measures, past measures limited to 10 days per request, and the most recent 200 raw records (2-day window). [4, 3]
Retention
Not publicly documented No cloud retention period is stated in the API specification or pages reviewed. [3, 1]
Sampling and aggregation
Conditional Cloud history is returned in 5-minute or 60-minute buckets “depending on what is available”. [3]
Timestamps and timezone
Available ISO 8601 with UTC offset (e.g. 2022-03-28T12:07:40Z); request parameters use basic format (20220328T120500Z). [3]
Rate limits
Not publicly documented No numeric rate limit appears in the published API specification. [3]
Export formats and limits
Conditional JSON via local and cloud APIs. No file-export format is documented in the sources reviewed. [3, 4]
Multiple devices and sites
Conditional The cloud API is organized by place and location IDs and offers averaged buckets across several locations. No enterprise fleet tooling was documented. [3, 2]
Integrations
Available Home Assistant, Homey, MQTT and community integrations; firmware and hardware designs are open source (CC-BY-SA 4.0). [1]
Usage and reuse restrictions
Restricted by terms A terms summary says owners own their monitor data, but the full terms restrict reselling or commercially exploiting “the services” without defining whether API output is included. The public dataset requires keeping provider, source and licence metadata when redistributed. [6, 7, 5]

AirGradient pricing: hardware, platform and API

Prices are shown only where the vendor publishes them, as checked on November 7, 2026. Taxes, shipping and implementation work are not included.

AirGradient ONE cost components
ComponentItemStatusPrice and basisNotes
HardwareAirGradient ONE, fully assembled and testedPublished priceUSD 230.00, one-time, per monitor (Region not stated on page)Power supply not included. [1]
HardwareAirGradient ONE kit (same hardware, no warranty or test report)Published priceUSD 138.00, one-time, per kit (Region not stated on page) [1]
PlatformAirGradient DashboardSources conflict: confirm with vendor—Described as subscription-free, while the assembled unit lists 12 months of dashboard and API access. Ask what applies after month 12. [1]
APICloud API tokenNot publicly disclosed—No separate API price was found; access is enabled in dashboard settings. [2]
GatewayGatewayNot applicable— [1]

Limitations and unresolved questions

Conflicting or unclear documentation

Not yet answered by public documentation

Before requesting a quote

These are ordinary links to the manufacturer. The editor, Justin Carlson, co-founded and leads Invivus Technologies, which runs Moldmap, SensiReport and Moldlist and is developing Aerlume, an indoor mold sensor. He has no financial relationship with AirGradient, Airthings, Atmocube or Kaiterra, no vendor pays for coverage or placement, and the site has no affiliate links. Indoor Air API Guide does not provide manufacturer support.

Sources

  1. AirGradient ONE indoor monitor product page, AirGradient (product). Checked November 7, 2026.
  2. Where do I access the API documentation, API token and local API?, AirGradient (support). Checked November 7, 2026.
  3. AirGradient Sensor API v1 specification (Swagger), AirGradient (documentation). Checked November 7, 2026. The interactive docs at /public/docs/api/v1/ did not render; the JSON specification did.
  4. Local server API (firmware documentation), AirGradient firmware repository (documentation). Checked November 7, 2026. Linked from AirGradient’s knowledge base via github.com/airgradienthq/arduino, which now resolves to this repository.
  5. Global indoor air quality dataset, AirGradient (documentation). Checked November 7, 2026.
  6. Terms & conditions summary, AirGradient (terms). Checked November 7, 2026. Page date: Last updated February 6, 2024.
  7. Terms & Conditions (full text), AirGradient (terms). Checked November 7, 2026. Page date: Last updated February 5, 2024.

Method: how we review documentation and record unknowns. Spotted a change? Send a correction.

Compare with alternatives

Back to the full indoor air quality API comparison