Authentication

With this API documentation, you can explore and interact with all the endpoints of the AirQo API.

This documentation shares the RESTful api endpoints provided by AirQo for retrieving measurements and device metadata from the AirQo monitoring network.

The BASE URL

https://api.airqo.net/api/{VERSION_NUMBER}

Authentication

IMPORTANT: All API endpoints use token as a query parameter.

1. Get AirQo Account: Visit https://analytics.airqo.net/user/login

2. Register Client: Log in → Account Settings → API tab → Register CLIENT app

3. Create Token: Generate access token using client credentials

4. Use Token: Include as QUERY parameter in all requests

Example Request

GET https://api.airqo.net/v2/measurements/grids/64b7f3257249f0029fed743/recent?token=YOUR_ACCESS_TOKEN

✅ Correct: Query parameter | ❌ Wrong: Authorization header

Please note that the V1 endpoint for device measurements were deprecated on 30th July 2023.

Key Categories of Endpoints

Here are the key categories of endpoints you can use to retrieve measurements:

1. Recent

Recent Measurements

2. Historical

Historical Measurements

3. Forecasts

Forecasts

4. Metadata

Metadata

For support, please reach out to [email protected] to report bugs. We will also appreciate any feedback you would like to share with us!