import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.recordings.list(
    offset=0,
    limit=5, )
print(response)
{
  "api_id": "ff25223a-1c9f-11e4-80aa-12313f048015",
  "meta": {
    "limit": 3,
    "next": "/v1/Account/MA2025RK4E639VJFZAGV/Recording/?limit=3&offset=3",
    "offset": 0,
    "previous": null,
    "total_count": 948
  },
  "objects": [{
      "add_time": "2022-08-05 16:15:15.852059+05:30",
      "call_uuid": "c2c128e2-1c8c-11e4-9bff-1db8a9db0432",
      "conference_name": "noname",
      "recording_duration_ms": "345100.00000", // The duration of the recording in milliseconds
      "recording_end_ms": "1407235509007.00000", // The end time of the recording since epoch in milliseconds
      "recording_format": "mp3",
      "recording_id": "c2186400-1c8c-1124-a664-0026b945b522",
      "recording_start_ms": "1407235163907.00000", // The start time of the recording since epoch in milliseconds
      "recording_type": "conference",
      "recording_url": "http://s3.amazonaws.com/recordings_2013/c2186400-1c8c-1124-a664-0026b945b522.mp3",
      "resource_uri": "/v1/Account/MA2025RK4E639VJFZAGV/Recording/c2186400-1c8c-1124-a664-0026b945b522/"
    },
    {
      "add_time": "2022-08-05 16:05:21.993853+05:30",
      "call_uuid": "fc773e88-1c8b-11e4-b25a-0fe7bcc54670",
      "conference_name": "noname",
      "recording_duration_ms": "90700.00000",
      "recording_end_ms": "1407234920253.00000",
      "recording_format": "mp3",
      "recording_id": "fc2716b0-1c8b-11e4-bwad-842b2b17453e",
      "recording_start_ms": "1407234829553.00000",
      "recording_type": "conference",
      "recording_url": "http://s3.amazonaws.com/recordings_2013/fc2716b0-1c8b-11e4-bwad-842b2b17453e.mp3",
      "resource_uri": "/v1/Account/MA2025RK4E639VJFZAGV/Recording/fc2716b0-1c8b-11e4-bwad-842b2b17453e/"
    }
  ]
}

This method lists the recordings that are available in your account.

API Endpoint

GET
https://api.plivo.com/v1/Account/{auth_id}/Recording/

Arguments

ArgumentsDescription
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:
  • add_time__gt: greater than
  • add_time__gte: greater than or equal to
  • add_time__lt: less than
  • add_time__lte: less than or equal to
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:
  • recording_storage_duration: equal to the specified duration
  • recording_storage_duration__gt: greater than specified days
  • recording_storage_duration__gte: greater than or equal to specified days
  • recording_storage_duration__lt: less than specified days
  • recording_storage_duration__lte: less than or equal to specified days

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

import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.recordings.list(
    offset=0,
    limit=5, )
print(response)
{
  "api_id": "ff25223a-1c9f-11e4-80aa-12313f048015",
  "meta": {
    "limit": 3,
    "next": "/v1/Account/MA2025RK4E639VJFZAGV/Recording/?limit=3&offset=3",
    "offset": 0,
    "previous": null,
    "total_count": 948
  },
  "objects": [{
      "add_time": "2022-08-05 16:15:15.852059+05:30",
      "call_uuid": "c2c128e2-1c8c-11e4-9bff-1db8a9db0432",
      "conference_name": "noname",
      "recording_duration_ms": "345100.00000", // The duration of the recording in milliseconds
      "recording_end_ms": "1407235509007.00000", // The end time of the recording since epoch in milliseconds
      "recording_format": "mp3",
      "recording_id": "c2186400-1c8c-1124-a664-0026b945b522",
      "recording_start_ms": "1407235163907.00000", // The start time of the recording since epoch in milliseconds
      "recording_type": "conference",
      "recording_url": "http://s3.amazonaws.com/recordings_2013/c2186400-1c8c-1124-a664-0026b945b522.mp3",
      "resource_uri": "/v1/Account/MA2025RK4E639VJFZAGV/Recording/c2186400-1c8c-1124-a664-0026b945b522/"
    },
    {
      "add_time": "2022-08-05 16:05:21.993853+05:30",
      "call_uuid": "fc773e88-1c8b-11e4-b25a-0fe7bcc54670",
      "conference_name": "noname",
      "recording_duration_ms": "90700.00000",
      "recording_end_ms": "1407234920253.00000",
      "recording_format": "mp3",
      "recording_id": "fc2716b0-1c8b-11e4-bwad-842b2b17453e",
      "recording_start_ms": "1407234829553.00000",
      "recording_type": "conference",
      "recording_url": "http://s3.amazonaws.com/recordings_2013/fc2716b0-1c8b-11e4-bwad-842b2b17453e.mp3",
      "resource_uri": "/v1/Account/MA2025RK4E639VJFZAGV/Recording/fc2716b0-1c8b-11e4-bwad-842b2b17453e/"
    }
  ]
}