Call Recording Retrieval API

The TeleSign Call Recording Retrieval API enables you to download or delete call recordings you have created using the Voice API.


If you are looking for commands to start, stop, pause, or resume a recording, see Record a Call.

General Requirements

  • Base URL:
  • Protocols: https
  • Authentication: Basic
  • Encoding: Accepts only UTF-8 unicode characters as inputs.
  • Responds With: application/json

Basic Usage

If you have the reference ID of the call for which you want to get recordings, skip to step 2.

  1. Make a GET /v2/call_recording request to the service to get a list of all recordings within a specified date range. Save the reference ID of each call.
  2. Make a GET /v2/call_recording/{referenceid} request to the service to get recording details for one call by reference ID. Save the recording URLs. Repeat for each call.
  3. Download the recordings at those URLs.

For more usage details, see Download Recordings.


If the recording is stopped and then started again during a call, multiple call recording files are associated with that call’s reference ID.