# List marketplace domain 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.

Endpoint: GET /marketplace/domains/listings
Version: 1.0.0
Security: bearer

## Query parameters:

  - `q` (string)
    Search query to filter listings by domain name. Supports partial matching.

  - `tlds` (array, required)
    One or more TLD extensions to filter listings (e.g., com, xyz). At least one TLD must be provided.

  - `orderBy` (string)
    Field to sort results by.
    Enum: "price", "name", "listedAt"

  - `orderDirection` (string)
    Sort direction. Defaults to ascending.
    Enum: "ASC", "DESC"

  - `perPage` (number)
    Number of results per page (1–100).

  - `$page` (number)
    Page number for pagination (1-indexed).

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.domain` (string, required)
    The domain name listed for sale

  - `items.status` (string, required)
    Current listing status

  - `items.listPrice` (object, required)

  - `items.listPrice.usdCents` (number, required)
    Listing price in USD cents

  - `items.payout` (object, required)

  - `items.payout.address` (string, required)
    Wallet address designated to receive the payout

  - `items.owner` (object, required)

  - `items.owner.address` (string, required)
    Wallet address of the domain owner

  - `items.expiresAt` (number)
    Unix timestamp when the listing expires (if applicable)

  - `next` (object,null, required)

  - `next.page` (integer)

  - `next.limit` (integer)

## Response 400 fields (application/json):

  - `code` (string, required)
    Machine-readable error code
    Example: "VALIDATION"

  - `message` (string)
    Human-readable error description

  - `errors` (array)
    Individual errors when code is MULTIPLE_ERRORS

  - `errors.code` (string, required)

  - `errors.message` (string)

## Response 401 fields (application/json):

  - `code` (string, required)
    Machine-readable error code
    Example: "VALIDATION"

  - `message` (string)
    Human-readable error description

  - `errors` (array)
    Individual errors when code is MULTIPLE_ERRORS

  - `errors.code` (string, required)

  - `errors.message` (string)

## Response 403 fields (application/json):

  - `code` (string, required)
    Machine-readable error code
    Example: "VALIDATION"

  - `message` (string)
    Human-readable error description

  - `errors` (array)
    Individual errors when code is MULTIPLE_ERRORS

  - `errors.code` (string, required)

  - `errors.message` (string)

## Response 500 fields (application/json):

  - `code` (string, required)
    Machine-readable error code
    Example: "VALIDATION"

  - `message` (string)
    Human-readable error description

  - `errors` (array)
    Individual errors when code is MULTIPLE_ERRORS

  - `errors.code` (string, required)

  - `errors.message` (string)