---
title: "List ICANN contacts"
method: POST
path: "/mcp/v1/actions/ud_contacts_list"
tags: ["Contacts"]
---

# List ICANN contacts

`POST /mcp/v1/actions/ud_contacts_list`

## Request

- Base URL: `https://api.unstoppabledomains.com`
- URL: `https://api.unstoppabledomains.com/mcp/v1/actions/ud_contacts_list`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/unstoppabledomains/apis/user-api/docs/mcp/v1/actions/ud_contacts_list/post.ts> (a function with typed inputs; its response is checked against the schema)

List ICANN contacts configured for the authenticated user's account. Required for DNS domain registration (.com, .org, etc.).

## Request body

- object
  - `includeDisabled` boolean: Include disabled contacts (default: false)

## Response `200`

List of ICANN contacts

- ContactsListResponse
  - `contacts` object[]
    - `id` string: Contact ID
    - `firstName` string
    - `lastName` string
    - `email` string: Partially masked email
    - `phone` string: Partially masked phone
    - `city` string
    - `stateProvince` string
    - `countryCode` string
    - `organization` string
    - `status` 'active' | 'draft' | 'admin_disabled': Contact status: "active" = ready for checkout, "draft" = syncing with registrar (wait a few seconds), "admin_disabled" = cannot be used
  - `count` number: Total number of contacts
  - `accountEmail` string, nullable: User's account email (masked) - suggest using for new contacts for auto-verification
  - `accountEmailHint` string, nullable: Tip about automatic verification when contact email matches account email

## Other responses

- `401`: Authentication required

---

[API](https://skmtc.dev/unstoppabledomains/apis/user-api.md) - [All operations](https://skmtc.dev/unstoppabledomains/apis/user-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unstoppabledomains/apis/user-api/revisions/c1def8e34b41?raw)