Orders
Lists the signed-in customer’s orders at this store, newest first, one page at a time: walk with starting_after = the previous next_cursor while has_more is true, or read page=N. No totals or page counts are sent. Filter with status (all|ongoing|pending|delivered|completed, default all) and service (the store’s service slug, e.g. fashion).
Authorization
clientKey customerToken The store's API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
In: header
The customer access credential from any sign-in session answer (access_token). Account operations only — send as Authorization: Bearer <access_token> ALONGSIDE X-Client-Key. It is bound to one store: a credential issued for another vendor answers 403 here.
In: header
Query Parameters
Orders per page (default 10, max 50; alias of limit).
1 <= value <= 5010Only orders placed under this service of the store (its service slug, e.g. fashion).
Keyset cursor: pass the previous page next_cursor. Walk while has_more is true; a stale, tampered, cross-list or filter-changed cursor answers 422 starting_after_invalid. Never combine with page.
Items per read (alias of per_page, max 50). page mode caps at page 50 (page_too_deep); walk the cursor past that.
Header Parameters
Your store API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/store/orders?per_page=10&limit=10" \ -H "X-Client-Key: {{clientKey}}"{ "status": "success", "message": "Orders retrieved", "data": [ { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c91", "title": "Zuri Atelier", "currency": "NGN", "total_price": 28500, "delivery_fee": 0, "grand_total": 24225, "payment_status": "paid", "transaction_id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c93", "is_verified": true, "order_no": "26-0925-74101", "status": "processing", "order_type": "instant", "scheduled_date": null, "scheduled_time": null, "is_backorder_held": false, "backorder_ready_date": null, "delivery_method": "pickup", "payment_method": "online", "delivery_address": null, "pickup_address": null, "stage": 0, "earliest_delivery_time": null, "latest_delivery_time": null, "ready_window": null, "vendor": { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c01", "name": "Zuri Atelier", "slug": "zuri-atelier", "logo": "https://media.usequeek.com/uploads/stores/2207/logo.png", "address": "12B Admiralty Way, Lekki Phase 1, Lagos", "phone": "+234 803 555 0147", "email": "[email protected]", "map_lat": "6.4474000", "map_lng": "3.4712000" }, "created_by_id": null, "timeline": [ { "title": "Order Received", "description": "Waiting for Zuri Atelier to accept your order.", "time": null }, { "title": "Preparing Your Order", "description": "Your order is being prepared and will be ready for pickup soon.", "time": null }, { "title": "Ready for Pickup", "description": "Your order is ready! Head over to Zuri Atelier to pick it up.", "time": null }, { "title": "Picked Up", "description": "Your order has been picked up. Enjoy!", "time": null } ], "vendor_timeline": [ { "title": "Order Received", "description": "New order received for pickup.", "time": null }, { "title": "Preparing Your Order", "description": "You accepted the order and started preparation.", "time": null }, { "title": "Ready for Pickup", "description": "Order is ready — awaiting customer pickup.", "time": null }, { "title": "Picked Up", "description": "Order has been picked up by the customer.", "time": null } ], "vendor_note": null, "rider_note": null, "shopforme_fee": 0, "service_fee": 0, "is_confirmed": false, "rejected": false, "is_completed": false, "cancelled": false, "items_count": null, "started_at": null, "completed_at": null, "created_at": "3:58pm, 25/9/2026", "updated_at": "4:20pm, 25/9/2026" }, { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c94", "title": "Zuri Atelier", "currency": "NGN", "total_price": 28500, "delivery_fee": 0, "grand_total": 24225, "payment_status": "pending", "transaction_id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c93", "is_verified": false, "order_no": "26-0926-74102", "status": "pending_payment", "order_type": "instant", "scheduled_date": null, "scheduled_time": null, "is_backorder_held": false, "backorder_ready_date": null, "delivery_method": "pickup", "payment_method": "online", "delivery_address": null, "pickup_address": null, "stage": 0, "vendor": { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c01", "name": "Zuri Atelier", "slug": "zuri-atelier", "logo": "https://media.usequeek.com/uploads/stores/2207/logo.png", "address": "12B Admiralty Way, Lekki Phase 1, Lagos", "phone": "+234 803 555 0147", "email": "[email protected]", "map_lat": "6.4474000", "map_lng": "3.4712000" }, "created_by_id": null, "timeline": [ { "title": "Order Received", "description": "Waiting for Zuri Atelier to accept your order.", "time": null }, { "title": "Preparing Your Order", "description": "Your order is being prepared and will be ready for pickup soon.", "time": null }, { "title": "Ready for Pickup", "description": "Your order is ready! Head over to Zuri Atelier to pick it up.", "time": null }, { "title": "Picked Up", "description": "Your order has been picked up. Enjoy!", "time": null } ], "vendor_timeline": [ { "title": "Order Received", "description": "New order received for pickup.", "time": null }, { "title": "Preparing Your Order", "description": "You accepted the order and started preparation.", "time": null }, { "title": "Ready for Pickup", "description": "Order is ready — awaiting customer pickup.", "time": null }, { "title": "Picked Up", "description": "Order has been picked up by the customer.", "time": null } ], "vendor_note": null, "rider_note": null, "shopforme_fee": 0, "service_fee": 0, "is_confirmed": false, "rejected": false, "is_completed": false, "cancelled": false, "items_count": null, "started_at": null, "completed_at": null, "created_at": "3:58pm, 25/9/2026", "updated_at": "4:20pm, 25/9/2026" } ], "has_more": false, "next_cursor": null}Retrieves one of the signed-in customer’s orders with its items and amounts. {id} accepts the UUID id or the human order_no (e.g. 26-0925-74101) — the example calls the latter.
Authorization
clientKey customerToken The store's API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
In: header
The customer access credential from any sign-in session answer (access_token). Account operations only — send as Authorization: Bearer <access_token> ALONGSIDE X-Client-Key. It is bound to one store: a credential issued for another vendor answers 403 here.
In: header
Path Parameters
Header Parameters
Your store API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/store/orders/26-0925-74101" \ -H "X-Client-Key: {{clientKey}}"{ "data": { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c91", "title": "Zuri Atelier", "currency": "NGN", "total_price": 28500, "delivery_fee": 0, "grand_total": 24225, "payment_status": "paid", "transaction_id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c93", "is_verified": true, "order_no": "26-0925-74101", "status": "processing", "order_type": "instant", "scheduled_date": null, "scheduled_time": null, "is_backorder_held": false, "backorder_ready_date": null, "delivery_method": "pickup", "payment_method": "online", "delivery_address": null, "pickup_address": null, "table": null, "stage": 0, "earliest_delivery_time": null, "latest_delivery_time": null, "ready_window": null, "vendor": { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c01", "name": "Zuri Atelier", "slug": "zuri-atelier", "logo": "https://media.usequeek.com/uploads/stores/2207/logo.png", "address": "12B Admiralty Way, Lekki Phase 1, Lagos", "phone": "+234 803 555 0147", "email": "[email protected]", "map_lat": "6.4474000", "map_lng": "3.4712000" }, "created_by_id": null, "timeline": [ { "title": "Order Received", "description": "Waiting for Zuri Atelier to accept your order.", "time": null }, { "title": "Preparing Your Order", "description": "Your order is being prepared and will be ready for pickup soon.", "time": null }, { "title": "Ready for Pickup", "description": "Your order is ready! Head over to Zuri Atelier to pick it up.", "time": null }, { "title": "Picked Up", "description": "Your order has been picked up. Enjoy!", "time": null } ], "vendor_timeline": [ { "title": "Order Received", "description": "New order received for pickup.", "time": null }, { "title": "Preparing Your Order", "description": "You accepted the order and started preparation.", "time": null }, { "title": "Ready for Pickup", "description": "Order is ready — awaiting customer pickup.", "time": null }, { "title": "Picked Up", "description": "Order has been picked up by the customer.", "time": null } ], "vendor_note": null, "rider_note": null, "shopforme_fee": 0, "service_fee": 0, "is_confirmed": false, "rejected": false, "is_completed": false, "cancelled": false, "items_count": null, "started_at": null, "completed_at": null, "created_at": "3:58pm, 25/9/2026", "updated_at": "4:20pm, 25/9/2026", "status_label": "Processing", "status_img": "https://api.usequeek.com/images/icon/box.png", "user_id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c51", "pickup_map_lat": null, "pickup_map_lng": null, "items": [ { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c92", "quantity": 1, "title": "Ankara Midi Dress", "variant_id": "019b0c4d-5f10-7a02-8c61-0b2d4e6f8a02", "variant_title": "M", "variant_option_values": { "Size": "M" }, "variant_media": { "image": "https://media.usequeek.com/uploads/stores/2207/ankara-midi-dress.jpg", "video_url": null, "source": "product" }, "currency": "NGN", "total_price": 24225, "sale_price": 28500, "unit_price": 24225, "base_unit_price": 28500, "is_backorder": false, "backorder_ready_date": null, "discounted_amount": 4275, "created_at": "2026-09-25T14:58:00.000000Z", "addons": [], "properties": [] } ], "created_by": null, "rider": null, "rider_rating": 0, "rider_review_status": null, "vendor_review_status": null, "vendor_rating": 0, "virtual_account_id": null, "payment_link": null, "pay_link": "https://usequeek.com/store/pay/019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c91", "viewer_type": "customer", "amount_summary": { "title": "Order Summary", "view": "customer", "items": [ { "key": "sub_total", "label": "Sub Total", "type": "price", "amount": 28500 }, { "key": "discount", "label": "Discount", "type": "discount", "amount": 4275 }, { "key": "grand_total", "label": "Grand Total", "type": "total", "amount": 24225 } ] } }}Returns the payment link and data for an unpaid order of the signed-in customer. {id} accepts the UUID id or the human order_no. Only online orders answer a link: anything else 422s.
Authorization
clientKey customerToken The store's API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
In: header
The customer access credential from any sign-in session answer (access_token). Account operations only — send as Authorization: Bearer <access_token> ALONGSIDE X-Client-Key. It is bound to one store: a credential issued for another vendor answers 403 here.
In: header
Path Parameters
Header Parameters
Your store API key (Dashboard → Settings → API keys). pk_live_… public keys are for browser code and only work from an origin on the key's allowlist; sk_live_… private keys are for servers and native apps and need no Origin.
Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/store/orders/26-0926-74102/pay" \ -H "X-Client-Key: {{clientKey}}"{ "status": "success", "message": "Order payment details fetched successfully", "data": { "order": { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c94", "order_no": "26-0926-74102", "status": "pending_payment", "payment_status": "pending", "payment_method": "online", "currency": "NGN", "is_payable": true, "is_paid": false, "grand_total": "24225.00", "grand_total_text": "₦24225.00", "payment_link": "https://pay.usequeek.com/p/zuri-74102", "pay_link": "https://usequeek.com/store/pay/019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c94", "items": [ { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c92", "quantity": 1, "title": "Ankara Midi Dress", "variant_id": "019b0c4d-5f10-7a02-8c61-0b2d4e6f8a02", "variant_title": "M", "variant_option_values": { "Size": "M" }, "variant_media": null, "currency": "NGN", "total_price": 24225, "sale_price": 28500, "unit_price": 24225, "base_unit_price": 28500, "is_backorder": false, "backorder_ready_date": null, "created_at": "2026-09-25T14:58:00.000000Z", "addons": [], "properties": {} } ] } }}