Get Audio - Cleartext Labs

Get Audio

curl --request GET \
  --url https://api.example.com/v1/recordings/{id}/audio

{
  "url": "<string>",
  "contentType": "<string>",
  "duration": 123
}

GET

recordings

{id}

audio

Get Audio

curl --request GET \
  --url https://api.example.com/v1/recordings/{id}/audio

{
  "url": "<string>",
  "contentType": "<string>",
  "duration": 123
}

Returns a URL to download or stream the audio file for a recording.

Path Parameters

string

required

The recording ID

curl -X GET "https://app.transcord.app/api/v1/recordings/clx1234567890/audio" \
  -H "Authorization: Bearer tr_live_your_api_key"

url

string

Signed URL to download the audio file. Valid for 1 hour.

contentType

string

Audio MIME type (typically audio/wav or audio/mpeg)

duration

number

Audio duration in seconds

Response

{
  "url": "https://api.twilio.com/...",
  "contentType": "audio/wav",
  "duration": 342
}

The URL is a signed URL that expires after 1 hour. If you need long-term access, download the file and store it yourself.

If the recording is still being processed, you’ll receive a 202 Accepted response:

{
  "error": "Recording not ready",
  "status": "processing"
}

Status	Description
`202`	Recording is still processing
`401`	Invalid or missing API key
`404`	Recording not found