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",
      "created_at": "2026-01-05T15:04:05Z",
      "updated_at": "2026-01-05T15:04:05Z"
    }
  ],
  "next_cursor": "eyJjcmVhdGVkX2F0Ijoi..."
}

​
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
​
cursor
string
Pagination cursor from previous responsePass the next_cursor value from a previous response to fetch the next page.
​
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
​
next_cursor
string
Pagination cursor for the next page. null when there are no more results.

​
Success Response

{
  "data": [
    {
      "id": "650e8400-e29b-41d4-a716-446655440000",
      "email": "customer@example.com",
      "first_name": "John",
      "last_name": "Doe",
      "created_at": "2026-01-05T15:04:05Z",
      "updated_at": "2026-01-05T15:04:05Z"
    }
  ],
  "next_cursor": "eyJjcmVhdGVkX2F0Ijoi..."
}

​
Pagination

This endpoint uses cursor-based pagination.
  1. Make your initial request (optionally with limit)
  2. If next_cursor is not null, pass it as the cursor query parameter to fetch the next page
  3. Repeat until next_cursor is null