Sign in
Recording

Get recording playfiles

Retrieves the recording's individual playable audio files with streaming download URLs and precomputed waveform peaks for inline playback.

get/recordings/{id}/playfiles

Path parameters

idstring required

The recording's ID.

Response

The recording's playable files.

filenamestring

The original filename of the recording file.

direction'' | 'in' | 'out'

The audio direction of the file. Populated as in or out only when the recording references a call and has separate directional files; empty for confbridge or single-file recordings.

uri_downloadstring

Signed streaming URL for the audio file, suitable as an HTML audio element source.

tm_download_expirestring date-time

Timestamp when the download URL expires.

filesizeinteger

The size of the audio file in bytes.

durationnumber double

The duration of this audio file in seconds, computed from the WAV header. 0 when the header could not be parsed.

peaksnumber[]

Precomputed waveform peak values (absolute amplitude magnitude, 0.0 to 1.0) for the whole file, for rendering a waveform without downloading the audio. Empty when peak computation failed; playback still works via uri_download.

Example response

[
  {
    "filename": "call_852def0e-f24a-11ed-845f-e32a849e7338_2023-01-05T14:58:05Z_in.wav",
    "direction": "in",
    "uri_download": "https://storage.googleapis.com/voipbin-media/bin/852def0e-f24a-11ed-845f-e32a849e7338?X-Goog-Signature=abc123",
    "tm_download_expire": "2026-01-15T10:30:00.000000Z",
    "filesize": 573440,
    "duration": 35.84,
    "peaks": [
      0,
      0.12,
      0.34,
      0.56,
      0.21,
      0.08
    ]
  }
]

Changes

Changed in 1 of the 97 revisions of this API.1