Skip to main content
GET
/
v1
/
get-contact
/
{contactId}
Get Contact
curl --request GET \
  --url https://api.telli.com/v1/get-contact/{contactId} \
  --header 'Authorization: <api-key>'
{
  "contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "external_contact_id": "<string>",
  "external_url": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "gender": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "phone_number": "<string>",
  "in_call_since": "2023-11-07T05:31:56Z",
  "reached_at": "2023-11-07T05:31:56Z",
  "contact_details": {},
  "call_attempts": 123,
  "next_call_at": "2023-11-07T05:31:56Z",
  "email": "[email protected]",
  "timezone": "<string>",
  "salutation": "<string>",
  "status": "reached"
}

Authorizations

​
Authorization
string
header
required

API key must be provided as: Bearer <api_key>

Path Parameters

​
contactId
string<uuid>
required

The telli contact ID

Response

Contact details retrieved successfully

​
contact_id
string<uuid>

The telli contact ID

​
external_contact_id
string

Your unique internal identifier for the contact

​
external_url
string<uri>

External URL linking to the contact in your CRM or external system

​
created_at
string<date-time>

When the contact was created

​
gender
string

Contact's gender

​
first_name
string

First name of the contact

​
last_name
string

Last name of the contact

​
phone_number
string

Contact's phone number in E.164 format

​
in_call_since
string<date-time>

Timestamp of when current call started, null if not in call

​
reached_at
string<date-time>

When the contact was last successfully reached

​
contact_details
object

Custom variables passed to the AI agent

​
call_attempts
integer

Number of call attempts made to this contact

​
next_call_at
string<date-time>

When the next call is scheduled, null if no call scheduled

​
email
string<email>

Contact's email address

​
timezone
string

IANA timezone identifier (e.g. Europe/Berlin)

​
salutation
string

Formal title or greeting (e.g. 'Mr.', 'Ms.', 'Herr', 'Frau')

​
status
enum<string>

Current status of the contact

Available options:
reached,
not_reached,
in_progress
⌘I