Post Pool Bank Accounts
AuthorizationBearer <token>Scope: pool-bank-accounts:write
Idempotency-Key*stringUnique key making the create idempotent across retries (16-64 chars of A-Z a-z 0-9 _ -).
^[a-zA-Z0-9_-]{16,64}$application/json- body
Create an account-level pool bank account (pool_balance). asset and network are required. There is no bank_type field — the type is forced server-side. External-rail identifiers (IBAN, BIC/SWIFT, wire/FFC messages) are not collected on pool bank accounts.
asset*stringSettlement asset / currency, e.g. USD.
network*stringPayment rail, e.g. ach, wire, pix.
bank_name?stringaccount?stringAccount number.
routing_number?stringRouting number (e.g. US ABA).
bank_short_description?stringOptional human-readable label.
bank_code?stringbranch?stringbank_address?stringbank_city?stringbank_state?stringbank_postal_code?stringinstant_payment?stringinstant_payment_type?stringcountry?stringdeposit_reference?stringautoexchange?booleanWhen true, funds received on this account are auto-exchanged and settled to autoexchange_destination_wallet_id.
falseautoexchange_destination_wallet_id?|Wallet (wal_…) that receives auto-exchanged funds. Required when autoexchange is true.
Idempotent replay: the Idempotency-Key matched an existing pool bank account, returned unchanged.
application/json- response
An account-level pool bank account (pool_balance). Has no subaccount. Returned by pool create, pool replace-autoexchange, pool get-by-id, and as each element of the pool list.
id*stringBank account ID (bnk_…).
account_id*stringOwning account ID (acc_…).
asset*stringbank_type*"pool_balance""pool_balance"bank_name?stringaccount?stringrouting_number?stringbank_short_description?stringbank_code?stringbranch?stringnetwork*stringinstant_payment?stringinstant_payment_type?stringcountry?stringdeposit_reference?stringcompliance_status*stringunchecked on creation.
is_active*booleanautoexchange*booleanautoexchange_destination_wallet_id?stringDestination wallet for auto-exchange, when configured.
created_at*stringdate-timeupdated_at*stringdate-timecurl -X POST 'https://api.betaramps.com/pool/bank-accounts' \ -H 'Idempotency-Key: string' \ -H 'Content-Type: application/json' \ -d '{ "asset": "USD", "network": "ach", "bank_name": "JPMorgan Chase", "account": "000123456789", "routing_number": "021000021", "bank_code": "CHASUS33", "branch": "0002", "country": "US", "deposit_reference": "Pool settlement"}'{ "id": "bnk_0192f5b0-4d5e-7f6a-9b7c-8d9e0a1b2c34", "account_id": "acc_0192f4e0-1a2b-7c3d-8e4f-5a6b7c8d9e01", "asset": "USD", "bank_type": "pool_balance", "bank_name": "JPMorgan Chase", "account": "000123456789", "routing_number": "021000021", "bank_code": "CHASUS33", "branch": "0002", "network": "ach", "country": "US", "deposit_reference": "Pool settlement", "compliance_status": "unchecked", "is_active": true, "autoexchange": false, "created_at": "2026-10-31T12:00:00Z", "updated_at": "2026-10-31T12:00:00Z"}