---
title: "List a domain for sale"
method: PUT
path: "/api/domains/{domain}/for-sale"
tags: ["Domains"]
---

# List a domain for sale

`PUT /api/domains/{domain}/for-sale`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/domains/{domain}/for-sale`
- Auth: HTTP bearer

List a domain you own for sale on the Domani marketplace. Buyers can purchase it directly via the API. The domain must be active and not already listed.

**Fees:** Domani charges a platform commission (default 10%) on successful sales. The seller receives the listed price minus the commission. The buyer pays the full listed price.

Requires `domains:write` scope.

## Path parameters

- `domain` string, required

## Request body

- object
  - `price` number, required: Sale price in USD
  - `description` string: Optional listing description

## Response `200`

Domain listed for sale

- object
  - `listing` object
    - `id` string
    - `domain` string
    - `price` number
    - `currency` string
    - `description` string, nullable
    - `status` 'active'
    - `created_at` string, date-time
  - `hint` string

## Other responses

- `400`: Invalid request parameters
- `401`: Missing or invalid API key
- `404`: Domain not found
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)