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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.