Skip to content

Get a contact's recent calls

GET
/v1/contacts/{contact}/calls
curl --request GET \
--url https://api.caller9.app/v1/contacts/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/calls \
--header 'Authorization: Bearer <token>'

Returns the total number of calls with this contact’s number across all studios, plus the 5 most recent.

contact
required
string format: uuid

Contact ID (UUID).

Call summary.

Media typeapplication/json
object
total
required
integer
calls
required
Array<object>
<= 5 items

A recent call involving a contact.

object
guid

Call ID.

string
direction
string
Allowed values: inbound outbound
status
string
queued_at
string | null format: date-time
initiated_at
string format: date-time
answered_at
string | null format: date-time
ended_at
string | null format: date-time
called_number

The Caller 9 phone number involved.

string | null
studio_name
string | null

Example

{
"calls": [
{
"direction": "inbound"
}
]
}

Missing, invalid, expired or revoked API key.

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}

Not found, or belongs to another organization.

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}

Too many requests for this API key. Retry after Retry-After seconds.

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}
Retry-After
integer

Seconds until the rate-limit window resets.