API reference

Accounts

Multi-currency receiving details for customers and your own treasury.

POST/v1/accounts

Proposed design

Field	Type	Description
currency	string	Required. USD, EUR, or NGN.
customer	string	Customer ID for an end-user account. Omit for a treasury account.
label	string	Optional display label.

201 Created — then pending → active

{
  "id": "acct_9k2m40s1",
  "status": "pending",
  "currency": "USD"
}

// after provisioning
{
  "id": "acct_9k2m40s1",
  "status": "active",
  "details": {
    "account_name": "Adaeze Okafor",
    "bank_name": "Column Bank N.A.",
    "account_number": "8331009247",
    "routing_number": "021000021"
  }
}

EUR accounts returniban andbic; NGN accounts return a NUBANaccount_numberand bank name. Watchaccount.status.changedrather than polling.