# Fetch gas data

**GET /data/gases**

Get gases measurements for the selected instruments and time range.

Optionally choose what period to recalculate results to.

The maximum date range per request is 31 days. If you request a longer range, the server will respond with an error.<br>
The default Period is 1 minute.<br>
The period can be set to anything between 1 minute and 1 day. If you request a period outside this range, the server will respond with an error.

Requires an API key with the `data.enviro:read` scope.


## Servers
- Production server: https://api.mycirrus.cloud/v1 (Production server)



## Parameters


### Query parameters
- **instruments** (array[string])
  Serial numbers of selected instruments
- **start** (string(date-time))
  Start date and time for loading a range of data. Must be in UTC.

  This uses the ISO8601 format. For example, `2023-01-01T00:00:00Z` is 1st January 2023 at midnight UTC.
- **end** (string(date-time))
  End date and time for loading a range of data. Must be in UTC.

  This uses the ISO8601 format. For example, `2023-01-01T00:00:00Z` is 1st January 2023 at midnight UTC.
- **period** (string(duration))
  Period to recalculate data samples to.

  This cannot be less than the recorded data period.

  This uses the ISO8601 duration format. For example, `P1D` is 1 day, `PT1H` is 1 hour, `PT1M` is 1 minute.


## Responses
### 200
OK

#### Body: application/json (array[object])
- **startTime** (string(date-time))
  Time of the sample
- **duration** (integer)
  Duration of the sample in seconds
- **instrument** (string)
  Instrument serial number
- **co** (number | null)
  Carbon monoxide in parts per billion
- **cO2** (number | null)
  Carbon dioxide in parts per million
- **h2S** (number | null)
  Hydrogen sulphide in parts per billion
- **no** (number | null)
  Nitric oxide in parts per billion
- **nO2** (number | null)
  Nitrogen dioxide in parts per billion
- **o3** (number | null)
  Ozone in parts per billion
- **sO2** (number | null)
  Sulphur dioxide in parts per billion
- **voc** (number | null)
  Volatile organic compounds in parts per billion

### 401
Your access token is invalid or has expired

#### Body: application/json (object)
- **error** (string)
  Error code
- **description** (string)
  Description of the error

### 403
You do not have permission to access this data

#### Body: application/json (object)
- **error** (string)
  Error code
- **description** (string)
  Description of the error

### 429
You have made too many requests in a short time

#### Body: application/json (object)
- **error** (string)
  Error code
- **description** (string)
  Description of the error


[Powered by Bump.sh](https://bump.sh)