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

# Customers

> Organise payers and beneficiaries under your organisation for swaps and payment routes.

Customers represent the people or businesses you move money for — senders, recipients, merchants, or internal entities. Every organisation gets a **primary customer** at signup (representing the organisation itself). Existing swaps and routes without a customer are attributed to this primary customer.

**Required scopes:** `transfers:read` (list), `transfers:write` (create)

## Why customers matter

* Attach `customerId` to [swaps](/products/swaps) and [payment routes](/products/payment-routes) for per-counterparty tracking
* Filter `GET /v1/swaps?customerId=...` and `GET /v1/transactions?customerId=...`
* Reconcile by customer name in the transactions ledger

## List customers

```bash theme={null}
curl https://api.remitflex.io/v1/customers \
  -H "Authorization: Bearer $REMITFLEX_API_KEY"
```

Response:

```json theme={null}
{
  "status": "success",
  "message": "Customers fetched",
  "data": {
    "customers": [
      {
        "id": "uuid",
        "name": "Acme Ltd",
        "email": "treasury@acme.io",
        "type": "business",
        "isPrimary": true,
        "createdAt": "2026-06-01T00:00:00.000Z"
      }
    ],
    "total": 1
  }
}
```

## Create a customer

```bash theme={null}
curl -X POST https://api.remitflex.io/v1/customers \
  -H "Authorization: Bearer $REMITFLEX_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Supplier",
    "email": "jane@supplier.co.ke",
    "type": "individual"
  }'
```

| Field   | Rules                                              |
| ------- | -------------------------------------------------- |
| `name`  | 2–120 characters                                   |
| `email` | Valid email                                        |
| `type`  | `individual` or `business` (default: `individual`) |

## Dashboard

View and filter activity per customer at [dashboard.remitflex.io](https://dashboard.remitflex.io) — **Overview**, **Transactions**, **Payment routes**, and per-customer receipts. API keys cannot manage dashboard-only settings.

## API reference

<CardGroup cols={2}>
  <Card title="List customers" icon="users" href="/api-reference/list-customers">`GET /customers`</Card>
  <Card title="Create customer" icon="user-plus" href="/api-reference/create-customer">`POST /customers`</Card>
</CardGroup>