---
title: "Get a broker request"
method: GET
path: "/api/broker/{id}"
tags: ["Marketplace"]
---

# Get a broker request

`GET /api/broker/{id}`

## Request

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

Returns one of your broker requests. Requires `deals:read` scope.

## Path parameters

- `id` string, required

## Response `200`

Broker request

- object
  - `request` BrokerRequest: A request to acquire a specific taken domain (autonomous broker)
    - `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
- `404`: 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)