A MediaRecording resource exposes recording metadata and allows the deletion of a particular recording.
Returns a list of MediaRecordings.
Query parameters
-
The sort order of the list by
date_created. Can be:asc(ascending) ordesc(descending) withdescas the default.Values are
ascordesc. -
Status to filter by, with possible values
processing,completed,deleted, orfailed.Values are
processing,completed,deleted, orfailed. -
SID of a MediaProcessor to filter by.
Minimum length is
34, maximum length is34. Format should match the following pattern:^ZX[0-9a-fA-F]{32}$. -
SID of a MediaRecording source to filter by.
Minimum length is
34, maximum length is34. Format should match the following pattern:^[a-zA-Z]{2}[0-9a-fA-F]{32}$. -
How many resources to return in each list page. The default is 50, and the maximum is 1000.
Minimum value is
1, maximum value is1000.
curl \
--request GET 'https://media.twilio.com/v1/MediaRecordings' \
--user "username:password"
{
"media_recordings": [
{
"account_sid": "string",
"bitrate": 42,
"date_created": "2026-05-04T09:42:00Z",
"date_updated": "2026-05-04T09:42:00Z",
"duration": 42,
"format": "mp4",
"links": {},
"processor_sid": "string",
"resolution": "string",
"sid": "string",
"size": 42,
"source_sid": "string",
"status": "processing",
"status_callback": "https://example.com",
"status_callback_method": "HEAD",
"url": "https://example.com"
}
],
"meta": {
"first_page_url": "https://example.com",
"key": "string",
"next_page_url": "https://example.com",
"page": 42,
"page_size": 42,
"previous_page_url": "https://example.com",
"url": "https://example.com"
}
}