---
title: "List Orders"
method: GET
path: "/admin/orders"
---

# List Orders

`GET /admin/orders`

## Request

- Base URL: `https://api.twtapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.twtapi.com/admin/orders`
- Auth: none declared

订单列表（分页，可按状态过滤），按 id 倒序 = 最新在前。

status 过滤逻辑收在 _apply_order_filters，保证 total 与列表口径一致。
用户邮箱用一次 IN 查询批量取回再在内存里映射，避免逐单查 User（N+1）。
订单可能没有 user_id（游客单/后台代下单），所以先过滤 falsy 再 IN。

## Query parameters

- `page` integer
- `size` integer
- `status` string, nullable: pending | paid | cancelled

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/twtapi/apis/twtapi-backend.md) · [All operations](https://skmtc.dev/twtapi/apis/twtapi-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/twtapi/apis/twtapi-backend/revisions/5295976febaf?raw)