public.customers
List Customers
Lists all customers for the authenticated merchant with optional filtering and pagination
get/v1/customers
Query parameters
limitinteger
Number of results per page (default: 50, max: 200)
pageinteger
Page number (default: 1)
emailstring
Filter by exact email address
Response
OK
Example response
{
"data": [
{
"capabilities": [
{
"name": "base",
"status": "approved"
}
],
"created_at": "2025-01-05T15:04:05Z",
"email": "customer@example.com",
"first_name": "John",
"id": "650e8400-e29b-41d4-a716-446655440000",
"last_name": "Doe",
"paystack_funding_account_readiness": {
"account_number_last4": "6789",
"bank_code": "058",
"status": "READY",
"updated_at": "2026-08-10T12:00:00Z"
},
"updated_at": "2025-01-05T15:04:05Z"
}
]
}Changes
No recorded changes to this endpoint across all 1 revision of this API.