---
title: "List your broker requests"
method: GET
path: "/api/broker"
tags: ["Marketplace"]
---

# List your broker requests

`GET /api/broker`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/broker`
- Auth: HTTP bearer

Lists your domain acquisition requests and their status. Requires `deals:read` scope.

## Query parameters

- `status` string

## Response `200`

Your broker requests

- object
  - `requests` BrokerRequest[]
    - `id` string
    - `domain` string
    - `status` 'sourcing' | 'contacted' | 'negotiating' | 'agreed' | 'completed' | 'no_contact' | 'declined' | 'expired' | 'cancelled'
    - `max_budget` number, nullable: Your ceiling in USD
    - `contacted` boolean: Whether the owner has been reached
    - `negotiation_id` string, nullable: Set once the owner engages and a negotiation opens
    - `failure_reason` string, nullable
    - `expires_at` string, date-time
    - `created_at` string, date-time

## Other responses

- `401`: Missing or invalid API key
- `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)