> ## Documentation Index
> Fetch the complete documentation index at: https://docs.luly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Audio Recording

> Retrieve your call’s audio recording.

### Headers

<ParamField header="authorization" type="string" required={true}>
  Your API key for authentication.
</ParamField>

<ParamField header="accept" type="string">
  Must be `application/json` to receive a url, or `audio/mpeg `to receive the audio file.
</ParamField>

### Path Parameters

<ParamField path="call_id" type="string">
  The ID of the call to retrieve the recording for.
</ParamField>

### Response

<ResponseField name="status" type="string">
  Can be `success` or `error`.
</ResponseField>

<ResponseField name="message" type="string">
  If the status is `success`, the `url` field will be present.

  A 404 error will be returned if the call does not exist or the recording is not available. We can only retrieve recordings if the call was created with `record` set to `true`.

  A 400/500 error will be returned if there is an error retrieving the recording.
</ResponseField>

<ResponseField name="url" type="string">
  If the status is `success`, the `url` will provide the exact location of the MP3 file storing the call’s audio.
</ResponseField>

<ResponseExample>
  ```json Success Response
  {
    "status": "success",
    "url": "https://URL-TO-FILE.mp3"
  }


  ```

  ```json Success Response 'audio/mpef'
  (returns the audio file)
  ```

  ```json Error
  {
    "status": "error",
    "message": "Error fetching recording"
  }
  ```
</ResponseExample>