API ReferenceStorefront
List storefront orders
GET /rest/v1/storefront/orders
Orders placed on the Nembol storefront, newest first, with the same conventions as /orders: cursor pagination, money as 2-decimal strings, prod_ / var_ ids. The id is the order number the buyer sees (order_…); the same order is also in GET /orders (as ord_…, channel storefront).
Required scope: orders:read.
Authorization
apiKey AuthorizationBearer <token>
Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.
In: header
Query Parameters
status?string
Any other value is a 422 (param: status).
Value in
- "pending"
- "paid"
- "fulfilled"
- "refunded"
- "partially_refunded"
- "canceled"
limit?integer
Range
1 <= value <= 100Default
25cursor?string
Response Body
application/json
application/json
curl -X GET "https://example.com/storefront/orders"{ "object": "list", "has_more": true, "next_cursor": "string", "data": [ { "id": "order_7KQ2M9XW4PZB", "object": "storefront_order", "status": "pending", "currency": "EUR", "subtotal": "15.90", "shipping": "5.00", "discount": "0.00", "discount_code": "string", "tax": "0.00", "total": "20.90", "refunded": "0.00", "buyer": { "email": "string", "name": "string", "phone": "string", "tax_ids": [ "string" ], "marketing_consent": true }, "billing_address": { "name": "string", "line1": "string", "line2": "string", "city": "string", "state": "string", "postal_code": "string", "country": "string" }, "shipping_address": { "name": "string", "line1": "string", "line2": "string", "city": "string", "state": "string", "postal_code": "string", "country": "string" }, "delivery_method": "shipping", "shipping_notes": "string", "lines": [ { "product_id": "prod_6ad22d0ee891b034a5693aa0", "variant_id": "string", "name": "string", "variant_title": "string", "sku": "string", "photo": "string", "quantity": 0, "unit_price": "15.90", "line_total": "15.90", "stock_shortfall": true } ], "payment": { "provider": "stripe", "paid_at": "2019-08-24T14:15:22Z" }, "tracking": { "number": "string", "carrier": "string", "url": "string" }, "created_at": "2019-08-24T14:15:22Z", "fulfilled_at": "2019-08-24T14:15:22Z", "refunded_at": "2019-08-24T14:15:22Z", "simulated": true } ]}Last updated on October 18, 2026
Need help?
Email us and a human replies, usually within one business day.