# Authentication

{% hint style="info" %}
This documentation shares the RESTful api endpoints provided by AirQo for retrieving measurements and device metadata from the AirQo monitoring network.
{% endhint %}

## The BASE URL

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

## Authentication

To access the AirQo Analytics API, you need to follow these steps:

1. **Get an AirQo Account:** Obtain an AirQo Analytics Account by visiting: <https://analytics.airqo.net/user/login>
2. **Register a Client:** Once you have an account, log in and navigate to your account settings. Under the API tab, register a new CLIENT application to generate client credentials.
3. **Create an Access Token:** With the client credentials, you can create an access token. This token will be used to authenticate your API requests.
4. **Use the token:** Copy the newly created access token and include it as a query parameter (`token`) in the API endpoints shared below.

{% hint style="warning" %}
Please note that the V1 endpoint for device measurements were deprecated on 30th July 2023.&#x20;
{% endhint %}

## Key Categories of Endpoints

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

### 1. Recent

{% content-ref url="../api-endpoints/recent-measurements" %}
[recent-measurements](https://docs.airqo.net/airqo-rest-api-documentation/api-endpoints/recent-measurements)
{% endcontent-ref %}

### 2. Historical&#x20;

{% content-ref url="../api-endpoints/historical-measurements" %}
[historical-measurements](https://docs.airqo.net/airqo-rest-api-documentation/api-endpoints/historical-measurements)
{% endcontent-ref %}

### 3. Forecasts

{% content-ref url="../api-endpoints/forecasts" %}
[forecasts](https://docs.airqo.net/airqo-rest-api-documentation/api-endpoints/forecasts)
{% endcontent-ref %}

### 4. Metadata

{% content-ref url="../api-endpoints/metadata" %}
[metadata](https://docs.airqo.net/airqo-rest-api-documentation/api-endpoints/metadata)
{% endcontent-ref %}

{% hint style="info" %}
For support, please reach out to <support@airqo.net> to report bugs. We will also appreciate any feedback you would like to share with us!
{% endhint %}