---
title: "List marketplace offers"
method: POST
path: "/mcp/v1/actions/ud_offers_list"
tags: ["Marketplace"]
---

# List marketplace offers

`POST /mcp/v1/actions/ud_offers_list`

## Request

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

List incoming offers on domains you own. Filter by domain or status.

## Request body

- object
  - `domainName` string: Filter by specific domain name
  - `group` 'active' | 'sold': Filter by group: "active" (pending) or "sold" (completed)
  - `page` number: Page number (1-indexed)

## Response `200`

List of offers

- ListOffersResponse
  - `offers` object[]
    - `id` number: Offer ID
    - `domainName` string
    - `priceInCents` number
    - `priceFormatted` string
    - `buyerUserId` string
    - `buyerStatus` string
    - `sellerStatus` string
    - `expiresAt` string
    - `createdAt` string
    - `updatedAt` string
  - `pagination` object
    - `page` number
    - `pageSize` number
    - `totalPages` number
    - `total` number
    - `hasMore` boolean
  - `truncated` boolean: Indicates if the offers list was truncated to meet response size limits
  - `truncationMessage` string: Optional message providing details about the truncation

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