> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usenumero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Customers

> Create end-customer records you can attach virtual accounts, transactions and KYC to — a durable identity for the people who pay you.

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

```
1. Create a customer      →  Numero returns a customer id
2. Attach virtual accounts →  Collections made to those accounts roll up under the customer
3. 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](/api-reference/customers-create)).

## 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        |