List Recordings

In order to retrieve all recordings you can use this request.

List recordings

get

List recordings

Authorizations

accessKey

HTTPRequired

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

Path parameters

workspaceIdstringRequired

Query parameters

limitinteger · min: 1 · max: 99Optional

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

sourceIdstring · uuidOptional

The ID for the source.

channelIdstring · uuidOptional

The ID for the channel.

idstring · uuidOptional

The ID for the call.

directionstring · enumOptional

Direction of the call

Possible values:

startAtstring · date-timeOptional

Start date for the query

endAtstring · date-timeOptional

End date for the query

fromstringOptional

From number of the call

tostringOptional

To number of the call

statusstring · enumOptionalPossible values:

Responses

200

OK

application/json

A list of 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

Not found

application/json

get

/workspaces/{workspaceId}/recordings

HTTPcURLJavaScriptPython

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

{
  "results": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "source": "call",
      "sourceId": "123e4567-e89b-12d3-a456-426614174000",
      "channelId": "123e4567-e89b-12d3-a456-426614174000",
      "status": "accepted",
      "direction": "incoming",
      "originator": {
        "contact": {
          "id": "text",
          "identifierKey": "text",
          "identifierValue": "text"
        },
        "number": {
          "type": "pstn",
          "number": "text",
          "anonymous": true,
          "callerIdName": "text",
          "identity": "text",
          "countryIsoCode": "text"
        }
      },
      "receiver": {
        "contact": {
          "id": "text",
          "identifierKey": "text",
          "identifierValue": "text"
        },
        "number": {
          "type": "pstn",
          "number": "text",
          "anonymous": true,
          "callerIdName": "text",
          "identity": "text",
          "countryIsoCode": "text"
        }
      },
      "origin": "call-command-record",
      "duration": 1,
      "stereo": true,
      "format": "text",
      "transcription": true,
      "conferenceId": "123e4567-e89b-12d3-a456-426614174000",
      "url": "text",
      "roomInfoUrl": "text",
      "createdAt": "2026-05-12T15:50:21.431Z",
      "updatedAt": "2026-05-12T15:50:21.431Z",
      "endedAt": "2026-05-12T15:50:21.431Z",
      "startedAt": "2026-05-12T15:50:21.431Z"
    }
  ],
  "nextPageToken": "text"
}

Request

curl "/workspaces/{workpaceId}/recordings" \
     -H 'Authorization: AccessKey YOUR_SECRET_TOKEN'

Response