Skip to main content
GET
/
v1
/
customers
List Customers
curl --request GET \
  --url https://api.daya.co/v1/customers \
  --header 'X-Api-Key: <x-api-key>'
{
  "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
}

​
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 pageDefault: 50 | Max: 200
​
page
integer
Page number to retrieveDefault: 1
​
email
string
Filter by exact email addressExample: customer@example.com

​
Request Example

curl --request GET \
  --url 'https://api.daya.co/v1/customers?limit=50' \
  --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

{
  "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