---
title: "Read a broker inquiry's state (owner side)"
method: GET
path: "/api/broker/respond"
tags: ["Marketplace"]
---

# Read a broker inquiry's state (owner side)

`GET /api/broker/respond`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/broker/respond`
- Auth: none required

The owner-agent read path: poll the current, anonymized state of an inquiry with your `token` before acting. Returns the domain, the buyer's offer on the table, whose move it is, and the actions available now. Never exposes the buyer's identity or budget. Token-authorized.

## Query parameters

- `token` string, required

## Response `200`

Inquiry state

- object
  - `domain` string
  - `status` string
  - `your_turn` boolean: Whether it's the owner's move.
  - `current_offer_usd` number, nullable: The buyer's offer on the table.
  - `agreed_price_usd` number, nullable
  - `actions` string[]: Actions available now (subset of offer/counter/accept/decline/opt_out).

## Other responses

- `400`: Invalid or missing token

---

[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)