Voice Log Download

Download voice recordings for completed calls. This API provides programmatic access to call recordings in various formats.

Download Voice Recording

GET /v3/accounts/<account_sid>/calls/<call_sid>/voice-logs

Path Parameters

Parameter	Type	Description
account_sid	String	Your Exotel account SID
call_sid	String	Unique identifier of the call

Query Parameters

Parameter	Type	Required	Description
format	String	No	Audio format: mp3 (default) or wav
channel	String	No	single (mixed, default) or dual (separate agent/customer tracks)

Example Request

curl -X GET \
  'https://<api_key>:<api_token>@api.exotel.com/v3/accounts/<account_sid>/calls/abc123/voice-logs?format=mp3' \
  -H 'Content-Type: application/json'

Response

{
  "request_id": "req_log_001",
  "method": "GET",
  "http_code": 200,
  "response": {
    "voice_log": {
      "call_sid": "abc123",
      "recording_url": "https://s3-ap-southeast-1.amazonaws.com/exotelrecordings/your_account_sid/abc123.mp3",
      "recording_duration": 295,
      "recording_size_bytes": 472000,
      "format": "mp3",
      "channel": "single",
      "created_at": "2024-06-15T10:35:00.000Z",
      "expires_at": "2024-09-15T10:35:00.000Z"
    }
  }
}

info

Recording URLs are time-limited signed URLs. They expire after the period shown in expires_at. Request a new URL if the link has expired.

Recording Status Values

Status	Description
available	Recording is ready for download
processing	Recording is being processed
not_available	No recording exists for this call
expired	Recording URL has expired; make a new request to get a fresh URL

HTTP Status Codes

Code	Description
200	Success — Recording available
400	Bad Request — Invalid parameters
401	Unauthorized — Invalid credentials
404	Not Found — Call or recording does not exist
429	Too Many Requests — Rate limit exceeded