Get a contact
GET
/v1/contacts/{contact}
const url = 'https://api.caller9.app/v1/contacts/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';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/contacts/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \ --header 'Authorization: Bearer <token>'Returns a single contact.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”contact
required
string format: uuid
Contact ID (UUID).
Responses
Section titled “Responses”The contact.
Media typeapplication/json
object
contact
required
object
guid
string
organization_guid
string
number
Phone number, E.164 where parseable.
string
first_name
string
last_name
string
location
string
notes
string
mood
string | null
tags
JSON-encoded array of strings, e.g. ["vip","regular"].
string
favourite
integer
created_at
string format: date-time
updated_at
string format: date-time
deleted_at
Always null for contacts returned by the API.
string | null
Example
{ "contact": { "tags": "[\"vip\",\"regular\"]", "favourite": 0 }}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"}Headers
Section titled “Headers”Retry-After
integer
Seconds until the rate-limit window resets.