---
title: "List orders"
method: GET
path: "/orders"
tags: ["Admin Sales: Orders"]
---

# List orders

`GET /orders`

## Request

- Base URL: `http://localhost:8000/api/admin`
- URL: `http://localhost:8000/api/admin/orders`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bagisto/apis/bagisto-admin-api/docs/orders/get.ts> (a function with typed inputs; its response is checked against the schema)

Paginated, filterable list of all orders across every customer. Returns a slim row per order in a `{ data, meta }` envelope; use the order detail and sub-resources for items / invoices / shipments.

## Query parameters

- `page` integer
- `per_page` integer
- `query` string
- `customer_id` integer
- `order_id` string
- `status` 'pending' | 'pending_payment' | 'processing' | 'completed' | 'canceled' | 'closed' | 'fraud'
- `grand_total` number
- `grand_total_from` number
- `grand_total_to` number
- `channel` integer
- `customer` string
- `email` string
- `date_range` 'today' | 'yesterday' | 'this_week' | 'this_month' | 'last_month' | 'last_three_months' | 'last_six_months' | 'this_year'
- `date_from` string, date
- `date_to` string, date
- `sort` string
- `order` 'asc' | 'desc'

## Response `200`

Paginated list of orders in the { data, meta } envelope.

## Changes

- **2026-10-28** `3198f11be70f`: 2 info
  - added the new optional `query` request parameter `customer_id`
  - added the new optional `query` request parameter `query`

[Operation history](https://skmtc.dev/bagisto/apis/bagisto-admin-api/changes/orders/get.md)

---

[API](https://skmtc.dev/bagisto/apis/bagisto-admin-api.md) - [All operations](https://skmtc.dev/bagisto/apis/bagisto-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bagisto/apis/bagisto-admin-api/revisions/3198f11be70f?raw)