Skip to main content
GET
List customers

What this endpoint does

Lists end customers onboarded under the current tenant account.

When to use it

Use it to build customer search, onboarding queues, and links into customer detail.

Before you call

Authenticate with an API key that can read this resource. Results are restricted to the tenant account bound to that key.

Money and balance effect

This is a read-only request. It does not reserve, debit, credit, or settle money.

States and completion

Customer and verification states are snapshots. Fetch the customer or its entitlements when you need current eligibility.

Safe retries

GET requests are read-only and may be retried with normal exponential backoff. Do not send an Idempotency-Key. Read Customers for the complete workflow.

Authorizations

Authorization
string
header
required

Send the same Wayex API key as Authorization: Bearer <key>.

Query Parameters

counterparty_id
string

Admin keys only: scope results to the given client account (counterparty). Non-admin callers passing this parameter receive 403 — it is never silently ignored.

cursor
string
required
limit
string
required

Response

A cursor-paginated page of customers.

data
object[]
required

The page of results, newest first.

hasMore
boolean
required

Whether a further page exists after this one.

nextCursor
string | null
required

Opaque cursor to pass as cursor to fetch the next page, or null at the end.