URL: /baas/api/reference/customer-apis

---
title: 'Customer APIs'
description: 'APIs for individual (B2C) and organization (B2B) customer lifecycle management'
---

# Customer APIs

Unified API surface for managing the complete customer lifecycle — registration, authentication, identity verification, consent collection, and account activation — for both individual and business customers.

<Info>
  **Base URL:** `https://sandbox.finhub.cloud/api/v2.1/customer`
</Info>

---

## Customer Types

<CardGroup cols={2}>
  <Card title="Individual (B2C)" icon="user" href="/baas/api/reference/customer-apis/individual">
    Personal customer onboarding: categorization, registration, sessions, verification, and activation
  </Card>
  <Card title="Organization (B2B)" icon="building" href="/baas/api/reference/customer-apis/organization">
    Business customer onboarding: registration, directors, employees, shareholders, and activation
  </Card>
</CardGroup>

---

## Shared Onboarding Pattern

Both B2C and B2B flows follow the same high-level pattern:

```mermaid
flowchart LR
    A[Register] --> B[Authenticate]
    B --> C[Verify Identity]
    C --> D[Upload Documents]
    D --> E[Accept Consents]
    E --> F[Activate]
```

### Individual (B2C) onboarding flow

```mermaid
flowchart TB
    I1["(1) Categorization"] --> I2["(2) Registration"]
    I2 --> I3["(3) Session creation"]
    I3 --> I4["(4) Verification"]
    I4 --> I5["(5) Document upload"]
    I5 --> I6["(6) Consent acceptance"]
    I6 --> I7["(7) Activation"]
```

### Organization (B2B) onboarding flow

```mermaid
flowchart TB
    O1["(1) Categorization"] --> O2["(2) Organization registration"]
    O2 --> O3["(3) Employee/personnel setup"]
    O3 --> O4["(4) Session creation"]
    O4 --> O5["(5) KYB verification"]
    O5 --> O6["(6) Document upload"]
    O6 --> O7["(7) Consent acceptance"]
    O7 --> O8["(8) Activation"]
```

| Step | Individual (B2C) | Organization (B2B) |
|------|------------------|--------------------|
| **Register** | `POST /individual/registration` | `POST /organization/registration` |
| **Personnel** | — | `POST /{orgId}/employee`, `GET /{orgId}/directors` |
| **Verify** | `POST /{customerId}/verification` | Via Verification & Compliance APIs |
| **Consents** | `POST /{customerId}/consents/{type}` | `POST /{orgId}/consents/{type}` |
| **Activate** | `POST /{customerId}/activation` | `POST /{orgId}/activation` |

<Note>
  Verification, document upload, and consent management are handled through the [Verification & Compliance](/baas/api/reference/verification-compliance) APIs, which are shared across both customer types.
</Note>

---

## Authentication

All Customer API endpoints require the following headers:

| Header | Required | Description |
|--------|----------|-------------|
| `Authorization` | Yes | `Bearer <token>` — OAuth 2.0 access token from an admin or customer session |
| `X-Tenant-ID` | Yes | Your tenant identifier |
| `Content-Type` | Yes | `application/json` for all POST requests |

```bash
curl -X POST "https://sandbox.finhub.cloud/api/v2.1/customer/individual/registration" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID" \
  -H "Content-Type: application/json" \
  -d '{ ... }'
```

---

## Related Resources

<CardGroup cols={2}>
  <Card title="Verification & Compliance" icon="shield-check" href="/baas/api/reference/verification-compliance">
    KYC/KYB verification, document upload, approval, and consent management
  </Card>
  <Card title="Administration" icon="gear" href="/baas/api/reference/administration">
    Admin sessions, roles, audit trails, and platform management
  </Card>
  <Card title="Financial Operations" icon="banknote" href="/baas/api/reference/financial-operations">
    Wallet balances, transfers, beneficiaries, and payment consents
  </Card>
  <Card title="Developer Tools" icon="code" href="/baas/api/reference/developer-tools">
    Webhook subscriptions and testing utilities
  </Card>
</CardGroup>