Updated 2026-06-01
Store API: Orders
List, get, create, update status, and cancel orders via the Store API.
The orders resource lets you read and manage orders programmatically — useful for headless checkouts, ERPs, and fulfillment integrations.
Order endpoints
GET
/v1/store/ordersList orders. Filters: status, paymentStatus, search.
Publishable keyGET
/v1/store/orders/countsOrder counts (new, action-needed).
Publishable keyGET
/v1/store/orders/:idGet a single order.
Publishable keyPOST
/v1/store/ordersCreate an order.
Secret keyPATCH
/v1/store/orders/:id/statusUpdate order status.
Secret keyPOST
/v1/store/orders/:id/cancelCancel an order.
Secret keyOrder totals computed server-side
When creating an order, totals (subtotal, tax, shipping, discount) are computed server-side from the line items, coupon, and shipping method — never trust client-sent totals.