Skip to main content
GET
/
api
/
v1
/
calls
/
{call_id}
/
recordings
Get Call Recordings
curl --request GET \
  --url https://api.example.com/api/v1/calls/{call_id}/recordings \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 123,
    "call_id": 123,
    "recording_sid": "<string>",
    "file_path": "<string>",
    "recording_url": "<string>",
    "duration": 123,
    "format": "wav",
    "recording_type": "full",
    "recording_source": "twilio",
    "status": "recording",
    "created_at": "2023-11-07T05:31:56Z"
  }
]
This endpoint retrieves a list of all recordings associated with a specific call, identified by its database ID.

​
Path Parameters

  • call_id (integer, required): The unique identifier for the call.

​
Response

The response is a JSON array of recording objects. Each object contains details about a recording, including a URL to the audio file.
Response
[
  {
    "id": 1,
    "call_id": 101,
    "recording_sid": "RExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "url": "https://api.twilio.com/2010-04-01/Accounts/AC.../Recordings/RE...",
    "duration": 300,
    "created_at": "2023-10-30T10:05:01Z"
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
call_id
integer
required

Query Parameters

​
recording_type
string | null

Filter by recording type

Response

Successful Response

​
id
integer
required
​
call_id
integer
required
​
recording_sid
string | null
​
file_path
string | null
​
recording_url
string | null
​
duration
number | null
​
format
string | null
default:wav
​
recording_type
string | null
default:full
​
recording_source
string | null
default:twilio
​
status
string | null
default:recording
​
created_at
string<date-time> | null