List Orders
Retrieve orders with filtering by status, date, and customer.
Updated
On this page
Overview
List orders for the authenticated customer. This is the same data accessible via dash.auth.getOrders().
SDK Usage
import dash from "@/lib/dash"
const { orders, pagination } = await dash.auth.getOrders({
limit: 20,
offset: 0,
})
Order List Object
{
"orders": [
{
"id": "ord_abc123",
"order_number": "ORD-1042",
"status": "shipped",
"subtotal": "59.98",
"shipping": "12.50",
"tax": "5.25",
"discount": "0.00",
"total": "77.73",
"item_count": 2,
"created_at": "2025-01-15T10:30:00Z"
}
],
"pagination": { "total": 15, "limit": 20, "offset": 0, "has_more": false }
}
REST API
GET /storefront/auth/orders?limit=20&offset=0
Authorization: Bearer {access_token}
X-API-Key: pk_live_your_key
Next Steps
- Get Order — Full order details
- Order Statuses — Understanding order states
The dashboard side of these endpoints is described in order management.