The calling shopper's orders, newest first
The calling shopper's own orders, newest first by created_at, ties broken by id so a page boundary never skips or repeats an order.
/v1/ordersThe calling shopper's own orders, newest first by created_at, ties broken by id so a page boundary never skips or repeats an order. Requires payments:read and a consumer token: an API key or staff session has no shopper self and is refused consumer_token_required (403). Cursor paged: pass the last id you saw as cursor; limit is clamped to 1-100 and defaults to 50.
Authorization
bearerAuth A tenant API key (sk_{env}_{id}_{secret}), a wallet user token, or an IdP access token. Which principal the credential resolves to decides the scopes it carries; see the authentication guide.
In: header
Query Parameters
Last seen id from the previous page. The listing resumes after that row, so an id that belongs to no row in the listing is refused invalid_request (400) rather than answered with an empty page.
uuid1 <= value <= 10050Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/orders"[ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "client_id": "5b3fa7ba-57d3-4017-a65b-d57dcd2db643", "merchant_id": "500924a8-3f5e-4c00-beb8-2efcde988aea", "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5", "status": "open", "subtotal": 0, "commission": 0, "total": 0, "payment_id": "d43b87f9-9e28-4802-8eaa-6ee91a40ea71", "expires_at": "2019-08-24T14:15:22Z", "restocked_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "lines": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "offering_id": "a7d124b6-6a8c-44d1-9d46-4636e3f8c04e", "variant_id": "8a2d415d-59aa-4132-bef3-011f97c4a0f6", "title": "string", "variant_title": "string", "sku": "string", "unit_amount": 0, "quantity": 0, "line_amount": 0, "commission": 0 } ] }]Put a paid order's units back on the shelf (after a refund), once
Puts a paid order's units back on the shelf after the money has been refunded — it moves stock, never money, and the refund is a separate call.
Reserve a cart from one merchant at catalog prices
Stock is reserved for each line (unless the variant does not track inventory or allows backorder) until the order is paid, canceled or expires.