API reference
Customers
Your end users — created by you, screened by us.
POST/v1/customers
| Field | Type | Description |
|---|---|---|
| type | string | Required. individual or business. |
| name | string | Required. Full legal name or registered business name. |
| partner_ref | string | Required, unique per environment. Your own ID for correlation. |
| country | string | Required. ISO 3166-1 alpha-2. |
| date_of_birth | date | Individuals. Needed for USD and EUR issuance. |
| incorporation_date | date | Businesses. |
| bvn | string | 11 digits. Needed before NGN issuance. |
201 Created
{
"id": "cus_adaeze01",
"kyc_status": "pending",
"partner_ref": "usr-1042",
"created_at": "2026-07-23T10:22:04Z"
}GET/v1/customers/:id
Returns the customer with currentkyc_status(pending, approved, needs_info, rejected) and any outstanding requirements by name.