Skip to main content
List calls
Cursor pagination. Pass the response’s next_cursor back as ?cursor= for the next page; has_more is false on the last page. Cursors are opaque — don’t parse them. An invalid cursor returns 400 invalid_cursor.
transcript is null in list items unless you pass include=transcript.

Authorizations

Authorization
string
header
required

Your API key as a Bearer token, e.g. Authorization: Bearer vk_….

Headers

authorization
string | null
X-Vocily-Workspace
string | null
X-Vocily-Org
string | null

Query Parameters

agent_id
string | null

Filter by agent id

status
string | null

Filter: started | completed | failed | …

direction
string | null

Filter: inbound | outbound

date_from
string<date-time> | null

started_at >= this datetime

date_to
string<date-time> | null

started_at <= this datetime

cursor
string | null

Opaque cursor from a previous response's next_cursor; omit for the first page

include
string | null

Comma-list of heavy fields to include. Currently: transcript

limit
integer
default:20
Required range: 1 <= x <= 100

Response

Successful Response

Envelope for GET /v1/calls. Cursor pagination: pass next_cursor back as ?cursor= for the next page; has_more is false on the last page. (A bare array can't carry paging metadata, and offset paging drifts under concurrent inserts — see app/services/pagination.py.)

data
PublicCallRead · object[]
required
has_more
boolean
required
next_cursor
string | null
required