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

# Consumers

Creates a new consumer and funds their initial wallet in a single call. The `initialFunds` amount is deducted from your partner wallet balance.

```text theme={null}
POST /api/partner/v1/customer
```

Below is a flow diagram explaining the steps.

<Frame>
  <img src="https://mintcdn.com/orbt/96Fd-vuJ5g0Urlz8/images/orbt-diagrams-Flow-3---Create-Consumer-and-Fund-Wallet.png?fit=max&auto=format&n=96Fd-vuJ5g0Urlz8&q=85&s=03f6dc58da6420bcabfc9cfdd3210bb4" alt="Orbt Diagrams Flow 3 Create Consumer And Fund Wallet" width="756" height="861" data-path="images/orbt-diagrams-Flow-3---Create-Consumer-and-Fund-Wallet.png" />
</Frame>

### Request headers

All standard authentication headers required. See the Authentication page.

### Request body

* `fullName` (string, required) — The consumer's full name
* `email` (string, required) — The consumer's email address. Must be unique per partner.
* `currency` (string, required) — ISO 4217 currency code, e.g. `USD`, `EUR`
* `initialFunds` (number, required) — Amount to load into the consumer's wallet on creation

### Example request

```text theme={null}
curl -X POST https://partner.orbt.com/api/partner/v1/customer \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-client-id: YOUR_CLIENT_ID" \
  -H "x-timestamp: 2026-06-03T10:00:00.000Z" \
  -H "x-body-hash: BODY_HASH" \
  -H "x-signature: SIGNATURE" \
  -d '{
    "fullName": "Jane Smith",
    "email": "jane.smith@yourcompany.com",
    "currency": "USD",
    "initialFunds": 50.00
  }'
```

### Success response (200)

```text theme={null}
{
  "success": true,
  "data": {
    "id": 101,
    "walletId": "101",
    "fullName": "Jane Smith",
    "email": "jane.smith@yourcompany.com",
    "walletBalance": 50.00,
    "currency": "USD"
  }
}
```

### Error responses

* **400 VALIDATION\_ERROR** — Consumer with this email already has a wallet in the requested currency
* **402 BUSINESS\_RULE\_ERROR** — Your partner wallet has insufficient funds to cover `initialFunds`
* **403 Forbidden** — Authentication failed. Check your credentials and signature.

## List consumers

Returns a paginated list of all consumers you have created.

```text theme={null}
GET /api/partner/v1/customer
```

### Query parameters

* `page` (integer, optional) — Page number, zero-indexed. Default: `0`
* `size` (integer, optional) — Number of results per page. Default: `20`, max: `50`

### Example request

```text theme={null}
curl -X GET "https://partner.orbt.com/api/partner/v1/customer?page=0&size=20" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-client-id: YOUR_CLIENT_ID" \
  -H "x-timestamp: 2026-06-03T10:00:00.000Z" \
  -H "x-body-hash: BODY_HASH" \
  -H "x-signature: SIGNATURE"
```

### Success response (200)

```text theme={null}
{
  "content": [
    {
      "consumerId": 101,
      "consumerName": "Jane Smith",
      "consumerEmail": "jane.smith@yourcompany.com",
      "totalStandardWallets": 1,
      "totalCampaignWallets": 0
    }
  ],
  "page": 0,
  "size": 20,
  "hasNext": false
}
```

### Error responses

* **403 Forbidden** — Authentication failed
* **422 Unprocessable Entity** — Invalid query parameters