Skip to main content
GET
List calls

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

include
enum<string>[]

Comma-separated list of optional payload sections to include. summary adds the call’s summary, voicemail the voicemail left on it. Omitted sections are left out of the response entirely, and voicemail is also left out for a call where none was left.

Maximum array length: 2
Available options:
summary,
voicemail
Examples:

"summary"

"summary,voicemail"

phoneNumberId
string

Only return calls on this Quo number.

Pattern: ^PN(.*)$
Example:

"PN123abc"

actorId

Only return calls belonging to this Quo user or system actor. An AI agent is a system actor, so its calls are reached with its SYU id.

Pattern: ^US(.*)$
Example:

"US123abc"

participant

Only return calls whose own originating or receiving number is this E.164 number, such as participant=+15555555555. To match any of several numbers, use participant[in]=+15555555555,+15555555556. Note that this is narrower than the participants array in the response: a party who joined a group call beyond those two numbers is listed in the response but is not matched by this filter.

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

"+15555555555"

direction
enum<string>

The direction of the call relative to the Quo number.

Available options:
incoming,
outgoing
Example:

"incoming"

status

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[gte]=2022-01-01T00:00:00Z&createdAt[lte]=2022-02-01T00:00:00Z. Both bounds are inclusive.

Example:
limit
integer
default:10

Max number of items to return per page.

Required range: 1 <= x <= 50
after
string
Example:

"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"

Response

OK

data
object[]
required
nextCursor
string | null
required

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

Example:

"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"