`GET /api/marketplace/purchases/{id}` — fetch a single purchase by ID. Only accessible to the buyer who owns the purchase.
GET
/api/marketplace/purchases/{id}
const url = 'https://example.com/api/marketplace/purchases/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://example.com/api/marketplace/purchases/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”id
required
string format: uuid
Responses
Section titled “Responses”Media typeapplication/json
A purchase record tying a buyer (user + workspace) to a specific item
version via a price row. All monetary amounts are in minor units (cents).
fee_policy_snapshot captures the fee settings at purchase time for audit.
object
amount_minor
required
integer format: int32
buyer_user_id
required
string format: uuid
buyer_workspace_id
required
string format: uuid
created_at
required
string format: date-time
currency
required
string
disputed_at
string | null format: date-time
fee_policy_snapshot
required
id
required
string format: uuid
item_version_id
required
string format: uuid
platform_fee_minor
required
integer format: int32
price_id
required
string format: uuid
provider_checkout_id
string | null
provider_fee_minor
required
integer format: int32
provider_payment_id
string | null
purchased_at
string | null format: date-time
refunded_at
string | null format: date-time
seller_profile_id
required
string format: uuid
status
required
Purchase lifecycle status (marketplace_purchases.status CHECK). Runtime
stays String; the spec narrows it to the closed [PurchaseStatusSpec].
string
updated_at
required
string format: date-time
Example
{ "status": "pending"}