List call history
const url = 'https://api.caller9.app/v1/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/calls?direction=inbound&page=1&limit=50';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/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/calls?direction=inbound&page=1&limit=50' \ --header 'Authorization: Bearer <token>'Paginated, newest-first history of inbound and outbound calls across the organization. Requires a full-access key.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Organization ID (UUID). Must be the organization that owns the API key.
Query Parameters
Section titled “Query Parameters”Phone number search. Non-digits are stripped; matches calls whose external party or dialed Caller 9 number contains the digits.
Filter by direction. Other values are ignored.
Filter to calls on a SIP trunk: a trunk ID, or any for calls on any trunk.
Page number (1-based).
Page size. Values are clamped to 1–200.
Responses
Section titled “Responses”A page of call history.
object
A call in the organization’s call history.
object
Call ID.
The external party (caller for inbound, callee for outbound), E.164.
Caller ID name (may equal the number).
SIP trunk the call used, if any.
Studio the call landed in (null for calls that never reached a studio).
The Caller 9 phone number involved.
That phone number’s label.
Total calls matching the filters.
Example
{ "calls": [ { "direction": "inbound", "call_type": "primary", "billable": 0, "went_to_voicemail": 0, "went_to_forward": 0, "forward_dest_type": "sip" } ]}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.