List calls

Fetch a paginated list of calls in the workspace, newest first. Every filter is optional, and group calls are included.

GET /calls

List calls

cURL

curl --request GET \
  --url https://dev-public-api.openphone.dev/calls \
  --header 'Authorization: <api-key>' \
  --header 'Quo-Api-Version: <quo-api-version>'

200

{
  "data": [
    {
      "id": "AC123abc",
      "phoneNumberId": "PN123abc",
      "userId": "US123abc",
      "direction": "incoming",
      "status": "completed",
      "participants": [
        {
          "phoneNumber": "[phone]",
          "userId": "US123abc"
        },
        {
          "phoneNumber": "[phone]",
          "userId": "US456def"
        },
        {
          "phoneNumber": "[phone]",
          "userId": null
        }
      ],
      "answeredAt": "2022-01-01T00:00:00Z",
      "answeredBy": "USlHhXmRMz",
      "initiatedBy": "USlHhXmRMz",
      "completedAt": "2022-01-01T00:00:00Z",
      "createdAt": "2022-01-01T00:00:00Z",
      "updatedAt": "2022-01-01T00:00:00Z",
      "callRoute": "phone-number",
      "duration": 60,
      "forwardedFrom": "US123abc",
      "forwardedTo": "US123abc",
      "aiHandled": "ai-agent"
    }
  ],
  "nextCursor": "eyJsYXN0SWQiOiJVU211a09NaXBhIn0"
}

Authorizations

Authorization · string · header · required

Headers

Quo-Api-Version · enum<string> · required

API version header. Supported values: 2026-03-30

Available options: 2026-03-30

Query Parameters

phoneNumberId · string

Only return calls on this Quo number.

Pattern: ^PN(.*)$

Example:

"PN123abc"

userId · string

Only return calls belonging to this Quo user. Requires an admin or owner when authenticating with a token.

Pattern: ^US(.*)$

Example:

"US123abc"

participant · string

Only return calls that involve this E.164 phone number, on either end.

Pattern: ^\+[1-9]\d{1,14}$

Example:

"[phone]"

direction · enum<string>

The direction of the call relative to the Quo number.

Available options: incoming, outgoing

Example:

"incoming"

status · enum<string> object

Only return calls with this status, such as status=missed. To match any of several statuses, use status[in]=missed,no-answer.

Available options: queued, initiated, ringing, in-progress, completed, busy, failed, no-answer, canceled, missed, answered, forwarded, abandoned

Example:

"missed"

createdAt · object

Bound the results by creation time, in ISO 8601 format: createdAt[gt]=2022-01-01T00:00:00Z&createdAt[lt]=2022-02-01T00:00:00Z.

Show child attributes

Example:

{ "gt": "2022-01-01T00:00:00Z" }

limit · integer · default: 10

Max number of items to return per page.

Required range: 1 <= x <= 50

after · string

Example:

"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"

Response

200

application/json

OK

data · object[] · required

Show child attributes

nextCursor · string | null · required

Cursor for the next page, or null when there are no more pages.

Example:

"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"