Sign in

v51

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014102371.0 MB
Recording

Get recording details

Retrieves detailed information about a specific recording.

get/recordings/{id}

Path parameters

idstring required

The recording's ID.

Response

The recording details.

idstring uuid

The unique identifier of the recording.

customer_idstring uuid

The customer ID that owns this recording. Returned from the GET /customers response.

owner_typestring

Type of the resource owner (e.g., call, confbridge).

owner_idstring uuid

The unique identifier of the resource owner. Returned from the corresponding owner resource endpoint (e.g., GET /calls, GET /conferences).

reference_type'call' | 'confbridge'

Type of reference for the recording.

reference_idstring uuid

The unique identifier of the referenced resource. The actual resource type is determined by reference_type. Returned from the corresponding resource endpoint.

status'initiating' | 'recording' | 'stopping' | 'ended'

The status of the recording.

format'wav'

The format of the recording.

activeflow_idstring uuid

The activeflow ID associated with this recording. Returned from the POST /activeflows or GET /activeflows response.

on_end_flow_idstring uuid

Flow ID to execute when recording ends. Returned from the POST /flows or GET /flows response.

tm_startstring date-time

The start timestamp of the recording.

tm_endstring date-time

The end timestamp of the recording.

tm_createstring date-time

The creation timestamp.

tm_updatestring date-time

The last update timestamp.

tm_deletestring date-time

The deletion timestamp, if applicable.

Example response

{
  "id": "e5f6a7b8-c9d0-1234-5678-90abcdef0123",
  "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "owner_type": "call",
  "owner_id": "c2d3e4f5-a6b7-8901-2cde-f01234567890",
  "reference_type": "call",
  "reference_id": "f6a7b8c9-d0e1-2345-6789-0abcdef01234",
  "status": "recording",
  "format": "wav",
  "activeflow_id": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
  "on_end_flow_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "tm_start": "2026-01-15T09:30:00.000000Z",
  "tm_end": "2026-01-15T09:30:00.000000Z",
  "tm_create": "2026-01-15T09:30:00.000000Z",
  "tm_update": "2026-01-15T09:30:00.000000Z",
  "tm_delete": "2026-01-15T09:30:00.000000Z"
}