Skip to content
Select themeSelect language

`GET /api/marketplace/seller/purchases/board` — the #691 §E server-paginated seller-listings board: filtered+paged purchase rows + total + (optional) status facets + the filter-tracking KPI (gross / fee / net / count).

GET
/api/marketplace/seller/purchases/board
curl --request GET \
--url https://example.com/api/marketplace/seller/purchases/board
limit
integer format: int64
offset
integer format: int64
status
string

Exact status facet (pending | active | refunded | disputed | …).

q
string

Free-text search over the purchase id.

sort
string

Whitelisted sort key: created_at | purchased_at | amount_minor | platform_fee_minor | status.

dir
string

Sort direction asc | desc (default desc).

include_facets
boolean

Recompute the seller-wide status facets (default true).

Media typeapplication/json

One page of the listings board: the page rows, the filtered total, optional status facets and the filter-tracking KPI.

object
facets
One of:
null
items
required
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
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
Allowed values: pending active refunded partially_refunded disputed revoked
updated_at
required
string format: date-time
kpi
required

The listings KPIs, over the FULL FILTERED set (tracks the active status filter). net_minor = gross − platform-fee (the tab’s Total / Fee / Net triple).

object
count
required
integer format: int64
fee_minor
required
integer format: int64
gross_minor
required
integer format: int64
net_minor
required
integer format: int64
total
required
integer format: int64
Example
{
"items": [
{
"status": "pending"
}
]
}