List customers for a merchant
Returns a paginated, searchable list of customer records belonging to the given merchant. Env-scoped — sandbox rows never appear in production listings.
Returns a paginated, searchable list of customer records belonging to the given merchant. Env-scoped — sandbox rows never appear in production listings.
Authorization
bearerAuth In: header
Path Parameters
Merchant UUID
uuidQuery Parameters
Column to order the WHOLE customer directory by (server-side, across every page), not just the rows on the current page. Defaults to created_at descending. email, phone and address are deliberately not sortable — ordering acts as a comparison oracle over unmasked customer PII — and return 400 invalid_sort_key, as do the tenant/merchant UUIDs and deleted_at.
"name" | "created_at" | "updated_at"Sort direction. Any other value returns 400 invalid_sort_order.
"asc" | "desc"Free-text search across name, email, and phone
11 <= value251 <= value <= 100Response Body
application/json
curl -X GET "https://example.com/v1/payments/merchants/497f6eca-6276-4993-bfeb-53cbbbba6f08/customers"{
"customers": [],
"total": 0,
"page": 1,
"limit": 25,
"total_pages": 1
}Was this page helpful?