> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# orders_list

> List orders. Narrow with a Shopify search string in `query`, e.g. 'financial_status:paid fulfillment_status:unshipped' to find orders waiting to ship. Only the last 60 days of orders are visible unless this app holds Shopify's `read_all_orders` scope, and older orders are absent rather than reported — do not read an empty result as an empty history.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"/admin/api/2026-07/graphql.json"}</code></div>

```python shopify_orders_list.py theme={null}
from charter.packs import shopify

result = await shopify.orders_list.ainvoke({})
```

<Note>
  Posts a GraphQL document to `POST /admin/api/2026-07/graphql.json`, as every tool in this pack does. Pages by cursor: `pageInfo.endCursor` is sent back as `variables.after`.
</Note>

## Body

<div className="reference-table">
  | Field       | Type                                                                      | Description           |
  | ----------- | ------------------------------------------------------------------------- | --------------------- |
  | `variables` | [OrdersListVariables](/charter/charter/packs/shopify/objects#orderslistvariables) | Paging and filtering. |
</div>