> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercurjs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List Order Groups
> Retrieve a paginated list of order groups.
Returns order groups — the customer-facing wrappers around per-seller orders created from a multi-seller cart.
Filtering by `seller_id` narrows results to order groups that contain at
least one order belonging to that seller.
## Query parameters
Maximum number of records to return.
Number of records to skip.
Field to sort by, prefix with `-` for descending order.
Comma-separated fields to include in the response.
Search term matched against order groups.
Filter by order group ID(s).
Filter by customer ID(s).
Filter to groups containing orders from the given seller(s).
Filter by order group status.
Filter by sales channel ID(s).
Filter by creation date using operators like `$gte` and `$lte`.
Filter by update date using operators like `$gte` and `$lte`.
## Response
The order group's ID.
ID of the customer who placed the order.
Number of sellers in the group.
The group's total amount.
Creation timestamp.
Last update timestamp.
Total number of matching order groups.
Number of records skipped.
Maximum number of records returned.
```bash cURL theme={null}
curl 'http://localhost:9000/admin/order-groups?customer_id=cus_01HXYZ&limit=20' \
-H 'Authorization: Bearer '
```
```ts JS Client theme={null}
const { order_groups, count } = await client.admin.orderGroups.query({
customer_id: "cus_01HXYZ",
limit: 20,
})
```
```json 200 theme={null}
{
"order_groups": [
{
"id": "og_01HXYZ8Q2M4N6P8R0T2V4W6X8Y",
"customer_id": "cus_01HXYZ",
"seller_count": 2,
"total": 7400,
"created_at": "2026-06-01T10:00:00.000Z",
"updated_at": "2026-06-01T10:00:00.000Z"
}
],
"count": 1,
"offset": 0,
"limit": 20
}
```