---
title: "Browse the expireds/pending-delete domain marketplace"
method: POST
path: "/mcp/v1/actions/ud_expireds_list"
tags: ["Backorders"]
---

# Browse the expireds/pending-delete domain marketplace

`POST /mcp/v1/actions/ud_expireds_list`

## Request

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

List domains that are approaching expiration or have recently dropped and are available for backorder registration. Supports filtering by status, TLD, label length, backorder count, and watchlist count.

## Request body

- object
  - `query` string: Search by domain name (exact match if contains dot) or label substring
  - `status` 'COMING_SOON' | 'AVAILABLE_BACKORDER': Filter by drop status: "COMING_SOON" (not yet dropped) or "AVAILABLE_BACKORDER" (already dropped)
  - `tlds` string[]: Filter by TLD extensions (e.g., ["com", "net"])
  - `sortBy` 'name' | 'deletionAt' | 'labelLength' | 'watchlistCount' | 'backorderCount': Sort field (default: "deletionAt")
  - `sortDirection` 'ASC' | 'DESC': Sort direction (default: "ASC")
  - `lengthRange` number[]: Filter by label length range [min, max]. Use max=0 for no upper bound.
  - `bidsRange` number[]: Filter by backorder count range [min, max]. Use max=0 for no upper bound.
  - `watchlistRange` number[]: Filter by watchlist count range [min, max]. Use max=0 for no upper bound.
  - `offset` number: Number of items to skip for pagination (default: 0)
  - `limit` number: Maximum number of items to return (1-500, default: 50)

## Response `200`

List of expiring/dropped domains

- object
  - `domains` object[]
    - `name` string: Full domain name
    - `deletionTimestamp` number: Unix timestamp in milliseconds when the domain drops/dropped
    - `status` 'COMING_SOON' | 'AVAILABLE_BACKORDER'
    - `labelLength` number: Length of the domain label
    - `watchlistCount` number: Number of users watching this domain
    - `backorderCount` number: Number of active backorders
  - `pagination` object
    - `total` number
    - `count` number
    - `offset` number
    - `limit` number
    - `hasMore` boolean
    - `nextOffset` number
  - `truncated` boolean: Whether the response was truncated to fit within size limits
  - `truncationMessage` string: Message indicating how many results were truncated

## Other responses

- `401`: Authentication required

## Changes

- **2026-03-13** `d4c4c4b514bd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/unstoppabledomains/apis/user-api/changes/mcp/v1/actions/ud_expireds_list/post.md)

---

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