---
title: "Respond to a broker inquiry (owner side)"
method: POST
path: "/api/broker/respond"
tags: ["Marketplace"]
---

# Respond to a broker inquiry (owner side)

`POST /api/broker/respond`

## Request

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

The owner-agent path: respond to a broker's acquisition inquiry using the `token` from the outreach email delivered to your inbox - the fully autonomous alternative to replying by email or clicking the human claim link. `offer`/`counter` open or advance an anonymous negotiation at your asking price; `decline` and `opt_out` end it. Token-authorized (the token is the capability) - no account or scope required.

## Request body

- object
  - `token` string, required: The outreach token from your inquiry email (the reply-to is broker+<token>@).
  - `action` 'offer' | 'counter' | 'accept' | 'decline' | 'opt_out', required: offer/counter to name a price; accept to take the buyer's current offer on the table; decline to refuse; opt_out to never be contacted again.
  - `price` number: Your asking price in USD (required for offer/counter).

## Response `200`

Response applied

- object
  - `handled` boolean
  - `outcome` string: opted_out | declined | negotiation_opened | countered | ignored_not_your_turn | unclear
  - `status` string
  - `negotiation_id` string
  - `domain` string

## Other responses

- `400`: Invalid token or missing price

---

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