---
title: "Get Contact"
method: GET
path: "/v1/get-contact/{contactId}"
---

# Get Contact

`GET /v1/get-contact/{contactId}`

Retrieves detailed contact information including current call status and history

## Path parameters

- `contactId` string, uuid, required

## Response `200`

Contact details retrieved successfully

- object
  - `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
  - `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` '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.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized - Invalid API key
- `404` — Contact not found

---

[API](https://skmtc.dev/telli/apis/telli-api.md) · [All operations](https://skmtc.dev/telli/apis/telli-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/telli/telli-api/revisions/9815a3c63c75/schema)