---
title: "List domain conversation leads"
method: POST
path: "/mcp/v1/actions/ud_leads_list"
tags: ["Leads"]
---

# List domain conversation leads

`POST /mcp/v1/actions/ud_leads_list`

## Request

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

List conversations about domains you own or are interested in. Includes buyer-seller messaging threads.

## Request body

- object
  - `domain` string: Filter by specific domain name (e.g., "example.crypto")
  - `skipEmpty` boolean: Skip conversations with no messages (default: true)
  - `skip` integer: Number of conversations to skip (pagination offset, default: 0)
  - `take` integer: Number of conversations to return (1-100, default: 20)

## Response `200`

List of conversations

- LeadsListResponse
  - `leads` object[]
    - `id` number: Conversation ID (use with ud_lead_messages_list)
    - `domainName` string
    - `domainId` number
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `shortLatestMessageContent` string: Preview of latest message (truncated to 100 chars)
    - `unreadMessageCount` number: Number of unread messages
    - `participants` object[]
      - `id` string: Encoded participant ID
      - `role` 'BUYER' | 'SELLER'
  - `total` number: Total number of conversations matching filters
  - `skip` number: Number of items skipped
  - `take` number: Number of items returned

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