Get Contact

Retrieves detailed contact information including current call status and history

get/v1/get-contact/{contactId}

Path parameters

contactIdstring uuid required

The telli contact ID

Contact details retrieved successfully

contact_idstring uuid

The telli contact ID

external_contact_idstring

Your unique internal identifier for the contact

external_urlstring uri

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

created_atstring date-time

When the contact was created

first_namestring

First name of the contact

last_namestring

Last name of the contact

phone_numberstring

Contact's phone number in E.164 format

in_call_sincestring date-time

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

reached_atstring date-time

When the contact was last successfully reached

contact_detailsobject

Custom variables passed to the AI agent

call_attemptsinteger

Number of call attempts made to this contact

next_call_atstring date-time

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

emailstring email

Contact's email address

timezonestring

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

salutationstring

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

status'reached' | 'not_reached' | 'in_progress'

Current status of the contact

auto_dialer_status'in_dialer' | 'not_in_dialer'

Whether the contact is currently enrolled in the auto dialer. Matches the status field of the auto_dialer_status_changed webhook.

No recorded changes to this endpoint across all 1 revision of this API.