v14

OpenAPI 3.1.02026-08-03122113375.9 KB
user-purchases

Get purchase

Get full detail for one buyer purchase.

Use this endpoint for order-tracking pages and deep purchase detail views.

What is included:

  • Orders, items, shipments, adjustments, refunds, and linked cases.
  • Seller user summaries.
  • Item metadata resolved from catalog search infrastructure.

Rules:

  • Purchase must belong to the authenticated user.
  • Returns 404 when purchase is missing or not owned.
get/user/purchases/{id}

Path parameters

idstring required

Purchase ID

Purchase ID

Response

Purchase

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

invoiceIdstring nullable

Invoice identifier generated for the purchase