> ## 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.

# customers_list

> List customers. Narrow with a Shopify search string in `query`, e.g. 'email:ada@example.com' or 'orders_count:>5'.

<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_customers_list.py theme={null}
from charter.packs import shopify

result = await shopify.customers_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` | [CustomersListVariables](/charter/charter/packs/shopify/objects#customerslistvariables) | Paging and filtering. |
</div>