Conversation status
The server’s view of a /buy conversation, for a confirm whose response never arrived: whether a turn is still running, the last checkout attempt (any outcome, with its code and approval link), and every order the conversation placed, read from the ledger. Same bearer scoping as POST /buy.
Read approval history
approval_history.created counts checkout authorizations and spending-policy approvals
created by this conversation, including those that expired or finished. An approval
reused from another conversation does not increase this count.
Use the count only when approval_history.complete is true. Incomplete history returns
{"complete": false, "created": null}. Incomplete history includes older conversations, a running turn,
an ownership change, or an approval whose creation conversation was not recorded.
Never treat a null count as zero.Authorizations
The user's connection access_token (user authentication), or an org-minted buy_token for org-owned accounts.
Path Parameters
The conversation_id returned by POST /buy.
Response
The conversation.
open, closed True while a POST /buy call is still running on this conversation. Poll until it clears, then read orders and last_checkout.
The most recent checkout attempt, whatever its outcome. Cleared when a new turn starts.
Every order this conversation placed, from the ledger, oldest first.
Every cart still on the table, each with its hash (the same shape as carts on POST /buy).
Asks that did not reach a cart, cumulative for the conversation (the same shape and rules as unmatched on POST /buy).
Approval records created by this conversation, including expired records. Incomplete history reports a null count.