Skip to main content
GET
Read a purchase conversation

Authorizations

Authorization
string
header
required

The user's connection access_token (user authentication), or an org-minted buy_token for org-owned accounts.

Path Parameters

id
string
required

The conversation_id returned by POST /buy.

Response

The conversation.

conversation_id
string
required
status
enum<string>
required
Available options:
open,
closed
turn_in_progress
boolean
required

True while a POST /buy call is still running on this conversation. Poll until it clears, then read orders and last_checkout.

last_checkout
object | null
required

The most recent checkout attempt, whatever its outcome. Cleared when a new turn starts.

orders
object[]
required

Every order this conversation placed, from the ledger, oldest first.

carts
object[]
required

Every cart still on the table, each with its hash (the same shape as carts on POST /buy).

unmatched
object[]
required

Asks that did not reach a cart, cumulative for the conversation (the same shape and rules as unmatched on POST /buy).

created_at
string<date-time>
updated_at
string<date-time>