---
title: "List Customers"
method: GET
path: "/v1/customers"
tags: ["public.customers"]
---

# List Customers

`GET /v1/customers`

Lists all customers for the authenticated merchant with optional filtering and pagination

## Query parameters

- `limit` integer
- `page` integer
- `email` string

## Response `200`

OK

- ListCustomersResponse
  - `data` CustomerResponse[]
    - `capabilities` CustomerCapability[]
      - `name` string — Name is the customer capability identifier. Currently returned values are "base" and "usd_banking".
      - `status` string — Status is the capability state. Returned values are "approved", "pending", "information_requested", "rejected", or "missing".
    - `created_at` string
    - `email` string
    - `first_name` string
    - `id` string
    - `is_verified` boolean
    - `last_name` string
    - `paystack_funding_account_readiness` PaystackFundingAccountReadiness
      - `account_number_last4` string
      - `bank_code` string
      - `missing_fields` string[]
      - `status` 'READY' | 'REQUIRES_INFORMATION'
      - `updated_at` string
    - `rejection_reasons` string[] — RejectionReasons contains the current blocking verification/capability issues. It is empty after approval.
    - `tier_1_kyc_complete` boolean
    - `tier_2_kyc_complete` boolean
    - `updated_at` string
  - `limit` integer
  - `page` integer
  - `total` integer
  - `total_pages` integer

## Other responses

- `400` — Invalid query parameters
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.dev/daya/apis/daya-external-api-public-api.md) · [All operations](https://skmtc.dev/daya/apis/daya-external-api-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/daya/daya-external-api-public-api/revisions/5fc72bf91a48/schema)