# Get an audio recording

**GET /data/audio/{recordingId}**

Get the audio data for the given recording

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


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



## Parameters

### Path parameters
- **recordingId** (string)
  The audio recording id to retrieve

### Query parameters
- **format** (string)
  Choose audio file format and codec


## Responses
### 200
OK

#### Body: application/octet-stream (string(binary))
string(binary)
### 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

### 404
There is an error in the request, possibly missing parameter or incorrect url.

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