Skip to main content
Returns a paginated list of calls for the authenticated project.
Calls GET /v1/call

Options

integer
Maximum number of calls to return (default: 20, max: 100).
string
Cursor for pagination - use the nextCursor value from a previous response.
string
Field to sort by (default: createdAt). One of createdAt, startedAt, endedAt, duration, title, status
string
Sort direction (default: desc). One of asc, desc
string
Filter by call status. One of RINGING, IN_PROGRESS, ENDED
string
Search text to filter calls by title, summary, or transcript.
string
Filter by simulation run plan job ID to get all calls from a specific simulation batch.
string
Calls from any of these simulation runs (run plan job ids), comma-separated, at most 100.
string
Calls from every run of any of these run plans, comma-separated, at most 100.
string
true: only simulated calls their run’s results count (not invalidated, for example because the agent never spoke). false: only the simulated calls the results leave out, each invalidated. Live calls, and calls removed from their run, match neither. One of true, false
string
true: leave out calls from runs hidden from the runs list. Live calls stay in. false is the same as leaving it out. One of true, false
object
Filter on custom properties, one entry per property name: properties[<name>][exists]=true keeps calls that have the property set (whatever the value), properties[<name>][exists]=false keeps calls missing it (never sent, sent as null, or removed). A property the project has never seen is missing on every call. Names match the way properties are stored, so planTier and plan_tier are one property. At most 20 properties; a name taken by a built-in call filter, such as status, is rejected with 400.

Example

Every command also takes the global options and sets one of the exit codes.