Returns a list of MediaProcessors
A MediaProcessor resource provides the ability to capture content from a web application with a Twilio Media Extension to create a livestream.
Returns a list of MediaProcessors.
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
started,endedorfailed.Values are
failed,started, orended. -
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.
GET
/v1/MediaProcessors
curl \
-X GET https://media.twilio.com/v1/MediaProcessors \
--user "username:password"
Response examples (200)
{
"media_processors": [
{
"account_sid": "string",
"date_created": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"ended_reason": "string",
"extension": "string",
"extension_context": "string",
"max_duration": 42,
"sid": "string",
"status": "failed",
"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"
}
}
Response examples (200)
{
"media_processors": [
{
"account_sid": "string",
"date_created": "2025-05-04T09:42:00Z",
"date_updated": "2025-05-04T09:42:00Z",
"ended_reason": "string",
"extension": "string",
"extension_context": "string",
"max_duration": 42,
"sid": "string",
"status": "failed",
"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"
}
}