Browse docs
Calls
List & Manage Calls
Try this APIRead past calls, fetch a single call, and end an in-progress call.
4 min read
List calls
http
GET /api/v1/public/callsReturns the most recent calls on your account, paginated with cursor-based pagination. Requires a private key (sk_live_…); public keys cannot list calls.
| Query param | Type | Default | Notes |
|---|---|---|---|
| limit | number | 20 | Page size. |
| starting_after | string | - | Cursor: pass the id of the last call from the previous page. |
httpExamples
GET /api/v1/public/calls?limit=10
GET /api/v1/public/calls?limit=10&starting_after=call_01HX…Retrieve a single call
http
GET /api/v1/public/calls/{call_id}httpExample
GET /api/v1/public/calls/call_01HXABC…Returns the full call object, including transcript_url and recording_url once the call has ended and post-processing is complete.
End an in-progress call
http
DELETE /api/v1/public/calls/{call_id}httpExample
DELETE /api/v1/public/calls/call_01HXABC…No body. Requires a private key (sk_live_…). Returns the updated CallResponse with status set to "rejected".
Related in Calls