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
idfrom this list with the purchase detail endpoint for deep inspection.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Page number, defaults to 1
x >= 1Results per page, defaults to 20
1 <= x <= 50Field to sort by
createdAt, updatedAt Sort direction
asc, desc Response
User purchases
Unique identifier for the purchase
Email address used for the purchase
Delivery charge in pence
Address where the order should be delivered
Subtotal in pence
Total in pence
Service fee in pence
Timestamp when the purchase was created
Timestamp when the purchase was last updated
Number of orders in the purchase
Purchase status
ACTIVE, REFUNDED, COMPLETED Invoice identifier generated for the purchase