Skip to main content
POST
Search calls
This capability is in beta. Behavior can change before general availability.
Search accepts the full call-condition grammar. Sort is registeredAt descending, and includeTotal must be false. Keep the query unchanged when following a cursor. A selected key cannot filter for an agent outside its selection.

Authorizations

Authorization
string
header
required

An API key (tars_sk_…) sent as Authorization: Bearer <key>. Each operation names the permission it needs. Create keys in Settings → Integrations → API keys.

Body

application/json

Filters, order and page of a call search.

filters
object[]
Maximum array length: 20
sort
object
limit
integer
default:50
Required range: 1 <= x <= 100
cursor
string | null
Maximum string length: 1024
includeTotal
any

Response

One page of results.

One page of a list.

items
object[]
required
nextCursor
string | null
required

Pass it as cursor to read the next page.

hasMore
boolean
required