Calls

Get Call Recording

GET
/v1/Calls/{callSid}/recordings/{recordingIndex}/download

Use your credentials to access the call recording by this endpoint. It returns the redirect link (pre-signed URL) to the call recording blob in the platform's recording storage, in the Location header of the 302 response. You should follow this redirect to access the media file. Note that this link will be valid for 15 minutes only and is regenerated every time you access this endpoint. Therefore, you MUST NOT cache or save it in any form.

AuthorizationBasic <token>

Basic Authorization header using the BASIC scheme. Use a pair companySid:token to access the API.

In: header

Path Parameters

callSid*string

Call Sid.

Match^(CA)[0-9a-f]{48}$
recordingIndex*integer

The index of the recording, 1-based.

Formatint32
Range1 <= value <= 2147483647

Response Body

curl -X GET "https://example.com/v1/Calls/string/recordings/1/download"
Empty
{  "errors": {    "Name": [      "The Name field is required."    ]  },  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",  "title": "One or more validation errors occurred.",  "status": 400,  "detail": "Some detailed message",  "traceId": "|4ef17786-b103-420e-89c0-cc425ac14809.edfcbee9_"}
{  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",  "title": "Error title",  "detail": "Error detailed message",  "traceId": "|4ef17786-b103-420e-89c0-cc425ac14809.edfcbee9_"}