Customers - Numero

A customer is a durable record for one of your end-users. Once created, you can attach virtual accounts to it, list the transactions that flowed through those accounts, and read the customer’s KYC status — all keyed off a single customer id. Use your own externalId to keep customers in sync with your system.

How it works

Create a customer      →  Numero returns a customer id
Attach virtual accounts →  Collections made to those accounts roll up under the customer
Read activity          →  List the customer's virtual accounts, transactions and KYC status

Authentication

Customer endpoints are authenticated with your API key only — no request signature is required. The create call additionally honours an idempotency key (see Create a customer).

Endpoints

Method	Endpoint	Description
POST	`/api/v1/business/customers`	Create a customer
GET	`/api/v1/business/customers`	List customers
GET	`/api/v1/business/customers/{id}`	Get a customer
PATCH	`/api/v1/business/customers/{id}`	Update a customer
DELETE	`/api/v1/business/customers/{id}`	Delete a customer
GET	`/api/v1/business/customers/{id}/virtual-accounts`	List the customer’s virtual accounts
GET	`/api/v1/business/customers/{id}/transactions`	List the customer’s transactions
GET	`/api/v1/business/customers/{id}/kyc`	Get the customer’s KYC status