Sign in

v14

latestOpenAPI 3.1.02026-08-03122113375.9 KB
user-purchases

List purchases

List purchases for the authenticated buyer.

Use this endpoint for purchase history overview pages.

Query behavior:

  • Supports pagination and sorting by creation/update timestamps.
  • Page size is capped at 50.
  • Useful for infinite-scroll and paged table UIs.

Response behavior:

  • Returns purchase summaries, not full order-level detail.
  • Includes derived seller-count information for each purchase.
  • Use the purchase id from this list with the purchase detail endpoint for deep inspection.
get/user/purchases

Query parameters

pageinteger

Page number, defaults to 1

Page number, defaults to 1

sizeinteger

Results per page, defaults to 20

Results per page, defaults to 20

sort'createdAt' | 'updatedAt'

Field to sort by

Field to sort by

direction'asc' | 'desc'

Sort direction

Sort direction

Response

User purchases

idstring cuid2 required

Unique identifier for the purchase

customerEmailAddressstring email required

Email address used for the purchase

deliveryChargeinteger required

Delivery charge in pence

subtotalinteger required

Subtotal in pence

totalinteger required

Total in pence

serviceFeeinteger required

Service fee in pence

status'ACTIVE' | 'REFUNDED' | 'COMPLETED'

Purchase status

createdAtstring date-time required

Timestamp when the purchase was created

updatedAtstring date-time required

Timestamp when the purchase was last updated

sellersinteger required

Number of orders in the purchase

invoiceIdstring nullable

Invoice identifier generated for the purchase