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

# List Customers

> List customers for the authenticated merchant

## Overview

Retrieve a paginated list of customers belonging to the authenticated merchant. Supports filtering by email.

## Authentication

**X-Api-Key** `string` *required*

Your merchant API key

## Query Parameters

**limit** `integer`

Results per page

**Default:** `50` | **Max:** `200`

**page** `integer`

Page number to retrieve

**Default:** `1`

**email** `string`

Filter by exact email address

**Example:** `customer@example.com`

## Request Example

```bash cURL theme={"dark"}
curl --request GET \
  --url 'https://api.daya.co/v1/customers?limit=50' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

```bash cURL - Filter by email theme={"dark"}
curl --request GET \
  --url 'https://api.daya.co/v1/customers?email=customer@example.com' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

## Response

**data** `array` *required*

Array of customer objects

**page** `integer` *required*

Current page number

**limit** `integer` *required*

Results per page

**total** `integer` *required*

Total number of customers matching the query

**total\_pages** `integer` *required*

Total number of pages available

### Success Response

```json 200 OK theme={"dark"}
{
  "data": [
    {
      "id": "650e8400-e29b-41d4-a716-446655440000",
      "email": "customer@example.com",
      "first_name": "John",
      "last_name": "Doe",
      "is_verified": false,
      "tier_1_kyc_complete": false,
      "tier_2_kyc_complete": false,
      "capabilities": [],
      "rejection_reasons": [],
      "created_at": "2026-01-05T15:04:05Z",
      "updated_at": "2026-01-05T15:04:05Z"
    }
  ],
  "page": 1,
  "limit": 50,
  "total": 1,
  "total_pages": 1
}
```

## Pagination

This endpoint uses **page-based pagination**.

1. Make your initial request (optionally with `limit` and `page`)
2. Check `total_pages` to determine how many pages are available
3. Increment `page` to fetch subsequent pages until you reach `total_pages`


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