# List fulfillment orders

**GET /v1/orders**

Paginated list of all fulfillment orders for the authenticated organization, including
pending, backordered, errored, cancelled, and shipped orders. Date filters apply to
order placed date, not ship date. Each row includes order value so volume, on-time
rate, error rate, and revenue can be derived. Tracking-only shipped orders remain on
GET /orders/tracking.


## Servers
- Public API: https://api.pattern.com/hub (Public API)
- Staging API: https://stage-api.pattern.com/hub (Staging API)


## Authentication methods
- Bearer auth


## Parameters


### Query parameters

- **page** (integer)
  Page number for pagination

- **per_page** (integer)
  Number of orders per page (default: 50)

- **start_date** (string)
  Filter orders placed on or after this date

- **end_date** (string)
  Filter orders placed on or before this date

- **market_order_id** (string)
  Filter to a specific marketplace order ID

- **status** (string)
  Filter to orders with a shipment in this status (e.g. backordered, canceled, shipped)



## Responses
### 200
Orders listed successfully

#### Body: application/json (array[object])
- **market_order_id** (string)
  Marketplace order ID

- **order_status** (string)
  Rolled-up order status

- **order_value** (number(float) | null)
  Order merchandise value

- **currency_code** (string | null)
  Order currency

- **order_placed_at** (string(date-time) | null)
  When the order was placed

- **latest_ship_by_date** (string(date) | null)
  Latest ship-by date

- **item_count** (integer | null)
  Number of line items

- **unit_count** (integer | null)
  Total unit quantity

- **shipments** (array[object])


### 422
Invalid date filter

#### Body: application/json (object)
- **errors** (array[string])



[Powered by Bump.sh](https://bump.sh)