List calls from a channel

Use this request to GET a list of all incoming and outgoing calls of a specific channel. You can include additional query parameters to filter the retrieved list.

Get calls from a channel

get

Get a list of calls from a channel

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

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

startAtstring · date-timeOptional

Start date for the query

endAtstring · date-timeOptional

End date for the query

statusstring · enumOptionalPossible values:

typestring · enumOptionalPossible values:

tostring · min: 1 · max: 100Optional

fromstring · min: 1 · max: 100Optional

durationintegerOptional

directionstring · enumOptionalPossible values:

idstring · uuidOptional

The ID for a call

tagstring[]Optional

Filter based on tag

Responses

200

OK

application/json

Responseall of

404

The request did not pass validation

application/json

422

The request did not pass validation

application/json

get

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

HTTPcURLJavaScriptPython

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

{
  "results": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "channelId": "123e4567-e89b-12d3-a456-426614174000",
      "from": "text",
      "to": "text",
      "originator": {
        "contact": {
          "id": "text",
          "identifierKey": "text",
          "identifierValue": "text"
        },
        "number": {
          "type": "pstn",
          "number": "text",
          "anonymous": true,
          "callerIdName": "text",
          "identity": "text",
          "countryIsoCode": "text",
          "pstnNumberType": "text"
        }
      },
      "receiver": {
        "contact": {
          "id": "text",
          "identifierKey": "text",
          "identifierValue": "text"
        },
        "number": {
          "type": "pstn",
          "number": "text",
          "anonymous": true,
          "callerIdName": "text",
          "identity": "text",
          "countryIsoCode": "text",
          "pstnNumberType": "text"
        }
      },
      "parentId": "123e4567-e89b-12d3-a456-426614174000",
      "direction": "incoming",
      "status": "accepted",
      "reason": "text",
      "type": "pstn",
      "duration": 1,
      "hangupCauseCode": 1,
      "hangupSource": "callee",
      "hangupSipCode": "text",
      "createdAt": "2025-12-08T11:44:51.542Z",
      "updatedAt": "2025-12-08T11:44:51.542Z",
      "ringingAt": "2025-12-08T11:44:51.542Z",
      "answeredAt": "2025-12-08T11:44:51.542Z",
      "endedAt": "2025-12-08T11:44:51.542Z",
      "scheduledFor": "2025-12-08T11:44:51.542Z",
      "callFlow": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "commands": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "callId": "123e4567-e89b-12d3-a456-426614174000",
            "callFlowId": "123e4567-e89b-12d3-a456-426614174000",
            "status": "text",
            "command": "text",
            "conditions": [
              {
                "variable": "keys",
                "operator": "eq",
                "value": "text"
              }
            ]
          }
        ]
      },
      "notification": {
        "url": "text"
      },
      "qualityInsights": {
        "mos": "text",
        "pdd": "text"
      },
      "sipInsights": {
        "hangupSipCode": "text",
        "edgeRegion": "text",
        "providerName": "text",
        "userAgent": "text",
        "remoteSignallingIp": "text",
        "remoteMediaIp": "text"
      },
      "amdResult": {
        "result": "human",
        "speech": "text",
        "locale": "text"
      },
      "sipType": "elastic",
      "tags": [
        "text"
      ]
    }
  ],
  "nextPageToken": "text"
}

Example 1: List calls from a workspace and a channel

You might consider filtering the call based on the channel and workspace using the available query parameters.

Request Headers

curl "/workspaces/{workspaceId}/channels/{channelId}/calls" \
     -H 'Authorization: AccessKey YOUR_SECRET_TOKEN'

Request Body

Response

Example 2: List calls from a workspace and a channel filtered by startAt and endAt

Request Headers

curl "GET /workspaces/{workspaceId}/channels/{channelId}/calls?startAt=2024-02-28T16%3A54%3A33.241Z&endAt=2024-03-01T16%3A54%3A33.241Z" \
    -H 'Authorization: AccessKey YOUR_SECRET_TOKEN'

Request Body

Response