Get a demand exchange (proposal pass)
The full story of one exchange for the calling storefront: condensed brief facts read from the persisted brief artifact, ordered passes with product allocation + pricing rows and expand-to-inspect snapshots from the persisted proposal artifacts, per-pass commercial outcome, and an exchange-level result (won if any pass won, else lost if the most recent decided pass lost, else pending). Grouped from persisted linkage only — one compose run and its proposal artifacts, never the content-addressed brief digest — so an exchange reads as a single composition pass until persisted cross-run lineage exists. A run with no captured artifact renders as unavailable, never reconstructed; a metric with no input is null, never 0. Scoped to the caller’s storefront — a run outside it returns 404.
Authorizations
API key or access token
Path Parameters
Surrogate id of the chef compose run that anchors this exchange (the demand-inbox ledger row id).
1 <= x <= 900719925474099142
Response
Get a demand exchange (proposal pass)
The full story of one brief → proposal → result exchange: brief facts, ordered passes with product allocation + pricing rows, per-pass outcome, and an exchange-level result. Every number is traceable to a persisted artifact or outcome record; missing inputs render unavailable, never 0.
The compose-run id anchoring this exchange.
Condensed brief facts read from the persisted brief artifact request (never reconstructed). Any field the buyer did not send is null.
False when no brief artifact was captured (historical run). Readers must say "brief unavailable" rather than reconstruct it.
The most recent proposal artifact id, for reference.
Exchange-level commercial result. Derivation rule: won if ANY pass is won; else lost if the most recent decided pass is lost; else pending. With one run per exchange today this equals the run outcome.
closed_won, closed_lost, pending Money won across the exchange, one entry per currency (both-or-nothing amount+currency per the AI-4726 money model; never summed cross-currency). Null when nothing won recorded a priced outcome.
The buyer's stated budget range. Surfaced at the exchange level so a lost exchange still shows the demand it represented (the AI-4726 lost-demand visibility).
agent, human A, B, C, D, F