---
title: "List marketplace domain listings"
method: GET
path: "/marketplace/domains/listings"
tags: ["marketplace"]
---

# List marketplace domain listings

`GET /marketplace/domains/listings`

Retrieve a paginated list of domains currently listed for sale on the Unstoppable Domains secondary marketplace. Use this endpoint to browse available domains, filter by TLD, and sort by price, name, or listing date.

Results are paginated — use the `$page` and `perPage` parameters to navigate through results.

## Query parameters

- `q` string
- `tlds` string[], required
- `orderBy` 'price' | 'name' | 'listedAt'
- `orderDirection` 'ASC' | 'DESC'
- `perPage` number
- `$page` number

## Response `200`

Paginated list of marketplace domain listings

- MarketplaceDomainsListingsResponse
  - `items` MarketplaceDomainsListingItemResponse[], required
    - `domain` string, required — The domain name listed for sale
    - `status` string, required — Current listing status
    - `listPrice` MarketplaceDomainsListingListPriceResponse, required
      - `usdCents` number, required — Listing price in USD cents
    - `payout` MarketplaceDomainsListingPayoutResponse, required
      - `address` string, required — Wallet address designated to receive the payout
    - `owner` MarketplaceDomainsListingOwnerResponse, required
      - `address` string, required — Wallet address of the domain owner
    - `expiresAt` number — Unix timestamp when the listing expires (if applicable)
  - `next` PaginatedListResponseNext, required
    - `page` integer
    - `limit` integer

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `403` — Insufficient permissions
- `500` — Internal server error

---

[API](https://skmtc.net/unstoppabledomains/apis/reseller-api.md) · [All operations](https://skmtc.net/unstoppabledomains/apis/reseller-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstoppabledomains/reseller-api/revisions/e0ac88d02fe7/schema)
