---
title: "Get Known Contacts Agent"
method: GET
path: "/settings/agent/known-contacts"
tags: ["Settings"]
---

# Get Known Contacts Agent

`GET /settings/agent/known-contacts`

Get all known contacts for the customer associated with the agent token.

This endpoint is designed for internal services (voice agents, etc.) that use agent tokens.
Returns all known contacts if the feature is enabled, or an empty list if disabled.

## Response `200`

Successful Response

- KnownContactsListResponse — List of known contacts response model (for agent endpoint)
  - `known_contacts_enabled` boolean, required — Whether known contacts feature is enabled for this customer
  - `contacts` KnownContactResponse[] — List of known contacts
    - `known_contact_id` string, uuid, required
    - `phone_number` string, required — Phone number in E.164 format
    - `name` string, required — Name of the contact
    - `first_name_phonetic` string, required — Phonetic spelling of first name for AI pronunciation

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/4a81645b59f6/schema)