> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Filter customers by email address

Use a new query parameter to filter customers by email address.

---

## What's new?

We added a new `email` query parameter that you can use when working with [the list customers operation](https://developer.paddle.com/api-reference/customers/list-customers.md) to return entities that match the specified email addresses.

{% api-endpoint method="GET" path="/customers?email="  %}

- **email** (array[string]): Return entities that exactly match the specified email address. Use a comma-separated list to specify multiple email addresses. Recommended for precise matching of email addresses
{% /api-endpoint %}

## How it works

The new `email` query parameter lets you filter [customers](https://developer.paddle.com/api-reference/customers/overview.md) by email address.

Unlike the `search` query parameter, the `email` parameter filters for exact matches. For example, if you pass `sam@example.com`, it returns entities where the email address is precisely `sam@example.com`.

It accepts a comma-separated list, so you can pass multiple email addresses and any exact matches are returned.

## Next steps

This change is available in version `1` of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.

You can [list customers](https://developer.paddle.com/api-reference/customers/list-customers.md) using the API to start using the new query parameter.
## Summary of changes

| Name | Type | Change | Entity | Description |
| --- | --- | --- | --- | --- |
| `email` | Field | added | List customers | Filter customers by email address. |