# Fetch a list of audio recordings

**GET /data/audio**

Get a list of all audio recordings for this instrumetn and time range

Requires an API key with the `data.audio: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.


## Responses
### 200
OK

#### Body: application/json (array[object])
- **id** (string)

- **instrument** (string)

- **startTime** (string(date-time))

- **endTime** (string(date-time))

- **triggerStartTime** (string(date-time))

- **triggerEndTime** (string(date-time))

- **triggerName** (string)


### 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)