List call recordings of a call

This endpoint lists all active call recordings of an active call. If you want to list recordings from a completed call, you should use the Recordings API.

Get call recordings from a call

get

Get a list of recordings from a channel call

Authorizations

accessKey

HTTPRequired

Uses the Authorization header: 'AccessKey ' followed by your access key token (e.g., 'Authorization: AccessKey AbCdEfGhIjKlMnOpQrStUvWxYzAbCdEfGhIj')

Path parameters

workspaceIdstring · uuidRequired

The ID of the workspace

callIdstring · uuidRequired

The ID for a call

channelIdstring · uuidRequired

The ID for a channel

Query parameters

limitinteger · min: 1 · max: 1000Optional

Limits the number of results to return

Default: 10

pageTokenstring · max: 8000Optional

Pagination token that keeps of track of the current position in the list

Responses

200

OK

application/json

A list of channel call recordings

nextPageTokenstringOptional

The token that can be passed as pageToken in URL to retrieve the next set of results. If missing, no more results to display.

404

The request did not pass validation

application/json

422

The request did not pass validation

application/json

get

/workspaces/{workspaceId}/channels/{channelId}/calls/{callId}/recordings

HTTPcURLJavaScriptPython

GET /workspaces/{workspaceId}/channels/{channelId}/calls/{callId}/recordings HTTP/1.1
Host: api.bird.com
Authorization: AccessKey YOUR_SECRET_TOKEN
Accept: */*

{
  "results": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "callId": "123e4567-e89b-12d3-a456-426614174000",
      "channelId": "123e4567-e89b-12d3-a456-426614174000",
      "status": "accepted",
      "origin": "call-command-record",
      "duration": 1,
      "stereo": true,
      "endCause": "text",
      "createdAt": "2026-03-20T15:41:37.758Z",
      "updatedAt": "2026-03-20T15:41:37.758Z",
      "startedAt": "2026-03-20T15:41:37.758Z",
      "endedAt": "2026-03-20T15:41:37.758Z"
    }
  ],
  "nextPageToken": "text"
}

Example 1: Get the list of call recordings

You might consider filtering the recording list based on a limit for example.

Request Headers

curl "https://api.bird.com/workspaces/{workspaceId}/channels/{channelId}/calls/{callId}/recordings" \
     -H "Authorization: AccessKey YOUR_SECRET_TOKEN"

Request Body

Response