---
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`

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.net/unstoppabledomains/apis/user-api.md) · [All operations](https://skmtc.net/unstoppabledomains/apis/user-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstoppabledomains/user-api/versions/c1def8e34b41/schema)