Sign in
Recordings

Get recording

Retrieves one voice call recording by ID. Use it after listing recordings or when a call event saved the recording identifier. Use Compatibility Retrieve recording for SID-based recording routes, or Get room recording for video-room media.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Voice.

Learn more about API scopes.

get/api/relay/rest/recordings/{id}

Path parameters

idstring uuid required

Universal Unique Identifier.

Unique ID of the recording.

Response

Recording model. A recording is associated with exactly one source type (PSTN, SIP, WebRTC, or Relay conference).

OR
OR
OR

Example response

{
  "duration_in_seconds": 2,
  "price": 0.05,
  "price_unit": "USD",
  "status": "completed",
  "url": "https://example.com/recording.mp3",
  "byte_size": 10,
  "track": "inbound"
}

Changes

Changed in 2 of the 137 revisions of this API.4

  • 492e0754dc701See the full diff
    • ○

      added ConferenceRecording to the response body anyOf list for the response status 200

      response-body-any-of-added

  • 20b0f48e796a3See the full diff
    • ○

      added the optional property anyOf[PstnRecording]/relay_conference_id to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[SipRecording]/relay_conference_id to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property anyOf[WebRtcRecording]/relay_conference_id to the response with the 200 status

      response-optional-property-added

Of the 137 revisions, 3 have a changelog that could not be searched.