Skip to main content
Operating, FBO and correspondent accounts are all accounts, and so are wallets. Every account has its own balance, its own ID and the financial addresses that reach it. On operating and correspondent accounts the holder is your own business; on an FBO account it is your customer. The program an account sits in decides what kind of account it is. See How the products are built.
​
id
string
required

Unique identifier of the account.

Example:

"550e8400-e29b-41d4-a716-446655440001"

​
type
enum<string>
required

Resource type discriminator.

Available options:
account
​
currency
enum<string>
required

Currency code (ISO 4217 or crypto).

Available options:
EUR,
GBP,
USD,
USDC
Example:

"USD"

​
status
enum<string>
required

Current status of the account.

Available options:
pending,
active,
frozen,
closed
Example:

"active"

​
asset_type
enum<string>
required

Asset type of the account.

Available options:
fiat,
crypto
​
label
string
required

Human-readable label for the account. For FBO accounts the label is set to the account holder’s name.

Example:

"Jane Doe"

​
financial_addresses
(ABA · object | IBAN · object | UK Sort Code · object | BIC · object | Wallet · object)[]
required

Payment identifiers (e.g. IBAN, account number, wallet address) through which this account can send or receive funds. US dollar accounts that use an ABA routing number also include a companion bic entry for inbound wires: it carries the bank’s SWIFT code, reuses the same account_number as the aba entry, and leaves local_bank_code null.

Example:
Example:
​
created_at
string<date-time>
required

ISO 8601 UTC timestamp when the account was created.

Example:

"2026-01-15T10:30:00Z"

​
updated_at
string<date-time>
required

ISO 8601 UTC timestamp when the account was last updated.

Example:

"2026-01-15T10:35:00Z"

​
metadata
object
required

Set of up to 50 key-value string pairs you can attach to store structured information, such as correlating this resource with an object in your own system. Keys may be up to 40 characters and values up to 500 characters.

Example: