---
title: "Get Contacts Batch"
method: POST
path: "/v1/get-contacts-batch"
---

# Get Contacts Batch

`POST /v1/get-contacts-batch`

Gets multiple contacts in a single request. Limited to 1000 contacts per request.

## Request body

- object
  - `contact_ids` string[], required — Array of telli contact IDs to retrieve. Maximum 1000 contacts per request.

## Response `200`

List of contacts retrieved successfully

- object[]
  - `status` 'success' | 'error' — Status of the contact retrieval
  - `contact` 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
    - `first_name` string
    - `last_name` string
    - `phone_number` string — Contact's phone number in E.164 format
    - `email` string, email
    - `salutation` string — Formal title or greeting (e.g. 'Mr.', 'Ms.', 'Herr', 'Frau')
    - `contact_details` object — Custom variables passed to the AI agent
    - `created_at` string, date-time — When the contact was created
    - `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
    - `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
    - `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.
  - `error` string — Error message (only present for failed retrievals)
  - `contactId` string, uuid — The contact ID that was attempted to be retrieved (only present for failed retrievals)

## Other responses

- `400` — Invalid request
- `401` — Unauthorized - Invalid API key

---

[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)