List a studio's call history
const url = 'https://api.caller9.app/v1/studios/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/calls?limit=100';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.caller9.app/v1/studios/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/calls?limit=100' \ --header 'Authorization: Bearer <token>'Returns the studio’s most recent calls (live and ended), newest first by
initiated_at. Not paginated; use limit (max 500).
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Studio ID (UUID).
Query Parameters
Section titled “Query Parameters”Maximum number of calls to return. Values above 500 are clamped to 500. Must be numeric.
Responses
Section titled “Responses”Call history for the studio.
object
A call-history record. Different endpoints return different subsets of
these fields: the studio call list returns every column; the organization
call log adds studio_name, did_number, number_name and trunk_name;
a contact’s call history returns guid, direction, status, timestamps,
called_number and studio_name. Integer flags are 0/1.
object
Call id (use with /v1/calls/{call}/…).
The organization’s number involved (the dialed DID for inbound; the caller ID used for outbound).
SIP trunk the call used, if any.
The external party in E.164 — the caller for inbound calls, the callee for outbound.
Display name of the external party (contact name, or the number).
Carrier call identifier (for support).
queued ringing/unanswered in the queue; screening with the AI screener;
hold on hold; browser with an operator’s browser; on-air on an on-air
line; ended finished; busy rejected busy; failed could not connect;
ringing used only for SIP-trunk calls in history.
Calling minutes reported for billing.
AI screening minutes reported for billing.
Forwarding destination, if the call was forwarded.
Audio codec negotiated with the caller.
Organization call log and contact history only.
Organization call log only — E.164 of the organization’s number involved.
Organization call log only — label of that number.
Organization call log only.
Contact call history only — E.164 of the organization’s number involved.
Example
{ "calls": [ { "direction": "inbound", "status": "queued", "call_type": "primary", "billable": 0, "went_to_voicemail": 0, "went_to_forward": 0 } ]}Missing, invalid, expired or revoked API key.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}The key isn’t allowed to do this (e.g. a read-only key making a change).
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Not found, or belongs to another organization.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Too many requests for this API key. Retry after Retry-After seconds.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Headers
Section titled “Headers”Seconds until the rate-limit window resets.