---
title: "List Admin Orders"
method: GET
path: "/api/v1/admin/orders"
tags: ["Admin Orders"]
---

# List Admin Orders

`GET /api/v1/admin/orders`

## Request

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

## Query parameters

- `status` 'draft' | 'submitted' | 'sourcing' | 'awaiting_customer' | 'proposals_ready' | 'proposal_approved' | 'payment_method_required' | 'payment_processing' | 'payment_action_required' | 'payment_failed' | 'paid' | 'ready_for_fulfillment' | 'fulfilling' | 'shipped' | 'delivered' | 'completed' | 'rejected' | 'cancelled'
- `status_group` 'active' | 'completed' | 'cancelled'
- `q` string, nullable
- `account_id` string, uuid, nullable
- `created_from` string, date-time, nullable
- `created_to` string, date-time, nullable
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- AdminOrderListOut
  - `items` AdminOrderSummaryOut[], required
    - `id` string, uuid, required
    - `order_number` string, required
    - `status` 'draft' | 'submitted' | 'sourcing' | 'awaiting_customer' | 'proposals_ready' | 'proposal_approved' | 'payment_method_required' | 'payment_processing' | 'payment_action_required' | 'payment_failed' | 'paid' | 'ready_for_fulfillment' | 'fulfilling' | 'shipped' | 'delivered' | 'completed' | 'rejected' | 'cancelled', required
    - `mailing_type` 'letter', required
    - `recipient_name` string, required
    - `company` string, nullable, required
    - `created_at` string, date-time, required
    - `submitted_at` string, date-time, nullable, required
    - `account_id` string, uuid, required
    - `account_name` string, required
    - `customer_name` string, required
    - `customer_email` string, required
  - `page` integer, required
  - `page_size` integer, required
  - `total` integer, required
  - `total_pages` integer, required
  - `has_next` boolean, required
  - `has_previous` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/g3m/apis/g3m-api.md) · [All operations](https://skmtc.dev/g3m/apis/g3m-api/llms.txt) · [OpenAPI document](https://skmtc.dev/g3m/apis/g3m-api/revisions/bfe1b239e8a7?raw)