Recordings

List and fetch recording metadata, and download recording audio.

List call recordings

GET

https://api.signals.pressone.africa

/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings.json

Returns metadata for every recording captured during the call. This list is not paginated. Entries do not carry a media URL; download the audio from the .wav resource of each recording.

List call recordings › path Parameters

AccountSid

string · pattern: ^AC[0-9a-f]{32}$ · required

Your Voice Account SID. It must equal the Basic authentication username.

Example: AC9ce1cd445308e3ec5080c6126288aa09

CallSid

string · pattern: ^CA[0-9a-f]{32}$ · required

SID of the call. Lowercase hexadecimal only; any other form returns 404.

Example: CA5388f7a5e04d0ed71cac5cdf1ea17a53

List call recordings › Responses

Recording list.

RecordingList

Recording[]

uri

string

Path of this request. This list is not paginated.

Example: /2010-04-01/Accounts/AC9ce1cd445308e3ec5080c6126288aa09/Calls/CA5388f7a5e04d0ed71cac5cdf1ea17a53/Recordings.json

GET/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Recordings.json

curl https://api.signals.pressone.africa/2010-04-01/Accounts/:AccountSid/Calls/:CallSid/Recordings.json \
  --header 'Authorization: Basic <credentials>'

Example Responses

{
  "recordings": [
    {
      "sid": "REd947fbd985d13ecb4c31eca3186f20bb",
      "account_sid": "AC9ce1cd445308e3ec5080c6126288aa09",
      "call_sid": "CA5388f7a5e04d0ed71cac5cdf1ea17a53",
      "duration": 42,
      "format": "wav",
      "date_created": "2026-07-02T12:00:00Z",
      "date_updated": "2026-07-02T12:00:42Z",
      "uri": "/2010-04-01/Accounts/AC9ce1cd445308e3ec5080c6126288aa09/Recordings/REd947fbd985d13ecb4c31eca3186f20bb.json"
    }
  ],
  "uri": "/2010-04-01/Accounts/AC9ce1cd445308e3ec5080c6126288aa09/Calls/CA5388f7a5e04d0ed71cac5cdf1ea17a53/Recordings.json"
}

json

application/json

Fetch a recording

GET

https://api.signals.pressone.africa

/2010-04-01/Accounts/{AccountSid}/Recordings/{RecordingSid}.json

Returns metadata for a single recording. The .json suffix is optional. To download the audio, request the same path with a .wav suffix.

Fetch a recording › path Parameters

AccountSid

string · pattern: ^AC[0-9a-f]{32}$ · required

Your Voice Account SID. It must equal the Basic authentication username.

Example: AC9ce1cd445308e3ec5080c6126288aa09

RecordingSid

string · pattern: ^RE[0-9a-f]{32}$ · required

SID of the recording. Lowercase hexadecimal only; any other form returns 404.

Example: REd947fbd985d13ecb4c31eca3186f20bb

Fetch a recording › Responses

Recording details.

Recording

sid

string

Unique identifier of this recording.

Example: REd947fbd985d13ecb4c31eca3186f20bb

account_sid

string

SID of the Voice Account that owns this recording.

Example: AC9ce1cd445308e3ec5080c6126288aa09

call_sid

string

SID of the call this recording was captured during.

Example: CA5388f7a5e04d0ed71cac5cdf1ea17a53

duration

integer

Recording duration in seconds. Omitted until the recording finishes.

Example: 42

format

string

Media format of the recording, for example wav. Omitted until known.

Example: wav

date_created

string · date-time

ISO 8601 creation timestamp.

Example: 2026-07-02T12:00:00Z

date_updated

string · date-time

ISO 8601 last-update timestamp.

Example: 2026-07-02T12:00:42Z

uri

string

Path of this recording resource.

Example: /2010-04-01/Accounts/AC9ce1cd445308e3ec5080c6126288aa09/Recordings/REd947fbd985d13ecb4c31eca3186f20bb.json

Download recording audio

GET

https://api.signals.pressone.africa

/2010-04-01/Accounts/{AccountSid}/Recordings/{RecordingSid}.wav

Streams the recording audio as WAV from Signals storage. This is the URL that RecordingUrl carries in action and recording status callback requests. Signals verifies the auth token itself on this path, and the recording must belong to the project that owns the Voice Account.

Send Range: bytes=START-END to fetch part of the file; a single range is supported, and the response is 206 Partial Content. If-Range with the current ETag keeps a range request valid only while the file is unchanged. HEAD returns the same headers without a body.

Download recording audio › path Parameters

AccountSid

string · pattern: ^AC[0-9a-f]{32}$ · required

Your Voice Account SID. It must equal the Basic authentication username.

Example: AC9ce1cd445308e3ec5080c6126288aa09

RecordingSid

string · pattern: ^RE[0-9a-f]{32}$ · required

SID of the recording. Lowercase hexadecimal only; any other form returns 404.

Example: REd947fbd985d13ecb4c31eca3186f20bb

Download recording audio › Headers

Range

string

A single byte range, for example bytes=0-1023, bytes=1024- or bytes=-4096.

Example: bytes=0-1023

If-Range

string

The ETag from an earlier response. When it no longer matches, Range is ignored and the whole file is returned.

Example: "7"

Download recording audio › Responses

The whole recording.

string

Calls Events