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

# Get Customers

> Retrieves a paginated list of customers for the specified store.
Requires the `stores.customers.view` permission.

## Filterable Fields

This endpoint supports filtering and sorting. See the [Filtering & Sorting Guide](/api-reference/filtering) for syntax details.

| Field              | Type    | Description                                          |
| ------------------ | ------- | ---------------------------------------------------- |
| `email`            | string  | Filter by email address (case-insensitive contains)  |
| `ipAddress`        | string  | Filter by IP address (case-insensitive contains)     |
| `balanceFrom`      | decimal | Filter by minimum balance (inclusive)                |
| `balanceTo`        | decimal | Filter by maximum balance (inclusive)                |
| `stripeCustomerId` | string  | Filter by Stripe customer ID (exact match)           |
| `affiliateCode`    | string  | Filter by affiliate code (case-insensitive contains) |

**Example:**

```bash theme={null}
# Customers with balance between $10 and $100
GET /stores/{storeId}/customers?filters=balanceFrom>=10,balanceTo<=100

# Customers by affiliate code
GET /stores/{storeId}/customers?filters=affiliateCode@=*PROMO
```


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.komerza.com/llms.txt).