Recording
List all recordings
This method lists the recordings that are available in your account.
API Endpoint
GET
Arguments
Arguments | Description |
---|---|
from_number (string) | Provide a source phone number (E.164 format) or SIP endpoint to retrieve recordings that match the number. |
to_number (string) | Provide a destination phone number (E.164 format) or SIP endpoint to retrieve recordings that match the number. |
subaccount (string) | Provide the auth_id of a subaccount if you want to filter only recordings for a given subaccount. |
call_uuid (string) | Use the call_uuid of the call to filter only recordings associated with a specific call. |
add_time (string) | Filter recordings based on the time they were added. The format is YYYY-MM-DD HH:MM[:ss[.uuuuuu]] . Filter options:
|
mpc_name (string) | Filter based on the name of the MPC if the recording belongs to a multiparty call. |
mpc_uuid (string) | Provide a multiparty call UUID to retrieve recordings that match that UUID. |
conference_name (string) | Provide a conference name to retrieve recordings that match that name. |
conference_uuid (string) | Provide a conference UUID to retrieve recordings that match that UUID. |
limit (string) | Number of results per page. Maximum value is 20. |
offset (string) | Number of records to skip (used for pagination). For example, with limit=10 and offset=705 , the results will include records 706 through 715. |
recording_storage_duration (integer) Cannot be used with add_time | Filter based on how long a recording was stored (in days). Filter options:
Default search window: 7 days Maximum search window: 30 days |
You can combine these filters to define a time range.
- If not used, Plivo defaults to a 7-day window from the current date.
- add_time
allows searching within a 30-day window, but older recordings are still accessible.
- If the time range exceeds 30 days, the API will return a 400 error.
- All timestamps must be in UTC.
You can combine these filters to get recordings that started within a particular time range.
Returns
Returns a Recording object