v28

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-044359269.1 KB

Accounts

Create account

Creates a new account.

post/v1/accounts

Headers

Idempotency-Keystring required

Idempotency key for safe retries. Reusing a key with an identical request body returns the cached response. Reusing a key with a different body returns 409.

Request body

account_program_idstring uuid required

ID of the account program to create the account under.

account_holder_idstring required

ID of an existing virtual account holder to provision the account for.

account_type'virtual_account' required

Type of account. Currently only virtual account.

Response

Account created successfully

idstring required

Unique identifier of the account.

type'account' required

Resource type discriminator.

currency'EUR' | 'GBP' | 'USD' | 'USDC' | 'BTC' | 'ETH' | 'SOL' | 'POL' required

ISO 4217 currency code for the account.

account_type'virtual_account' | 'payment_account' | 'collateral_account' required

Type of the account.

status'pending' | 'active' | 'frozen' | 'closed' required

Current status of the account.

asset_type'fiat' | 'crypto' required

Asset type of the account.

labelstring required

Human-readable label for the account.

created_atstring date-time required

ISO 8601 UTC timestamp when the account was created.

updated_atstring date-time required

ISO 8601 UTC timestamp when the account was last updated.