Confirm current status of the Awair Developer API and pull CO2/TVOC/PM2.5 readings from an Awair device

domain: developer-apis.awair.is · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Sign in to the Awair Home Developer Console at developer.getawair.com to get a personal Hobbyist-tier Bearer Token, or register an OAuth 2.0 client if you need to access other users' devices.
  2. Call GET https://developer-apis.awair.is/v1/users/self with the Bearer token to confirm your account, tier and quota.
  3. Call .../v1/users/self/devices to list devices, then the air-data endpoints (LATEST, RAW, FIVE_MIN, FIFTEEN_MIN) for temperature, humidity, CO2, TVOC and PM2.5 — each with its own daily per-device quota under Hobbyist.
  4. For OAuth 2.0 access to other users' devices, direct them to oauth-login.awair.is with response_type=code, then exchange the code at POST https://oauth2.awair.is/v2/token.
  5. Note that OAuth2 clients only reach 'Awair Home' (consumer) devices, not 'Awair Business' org devices, which use a separate Dashboard Developer API (docs.dashboard.getawair.com) with its own key.

Known gotchas

Related routes

Authenticate and read live radon/CO2/VOC values from a personal Airthings device via the official Airthings Consumer API
consumer-api.airthings.com · 5 steps · unrated
Pull live air quality readings (PM2.5, CO2, VOC) from a Kaiterra Laser Egg or Sensedge monitor via the Kaiterra REST API
api.kaiterra.com · 5 steps · unrated
Retrieve current or historical PM2.5 sensor readings from the PurpleAir API for a sensor or bounding box
api.purpleair.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans