`GET /api/marketplace/purchases` — list purchases for the authenticated buyer with optional status filter and pagination.

GET

/api/marketplace/purchases

const url = 'https://example.com/api/marketplace/purchases';
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

Parameters

Query Parameters

status

string

limit

integer format: int64

offset

integer format: int64

Responses

200

application/json

Array<object>

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

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

Allowed values: pending active refunded partially_refunded disputed revoked

updated_at

required

string format: date-time

Example

[
  {
    "status": "pending"
  }
]