Beta Ramps API
Bank accounts

Get Bank Accounts By Bank Account Id

GET
/bank-accounts/{bank_account_id}

Authorization

headerAuthorizationBearer <token>

Scope: bank-accounts:read

Path Parameters

bank_account_id*string

Response Body

The bank account.

application/json
  1. response

The full detail of a subaccount-scoped bank account, returned by get-by-id and as each element of the bank-accounts list. Carries more fields than the create response (holder, address, IBAN/BIC, routing number, inactivation time).

id*string

Bank account ID (bnk_…).

account_id*string

Owning account ID (acc_…).

subaccount_id?string

Owning subaccount ID (sub_…), when subaccount-scoped.

asset*string
network*string
bank_type*string
bank_short_description?string
bank_code?string
bank_name?string
branch?string
account?string
bank_address?string
bank_city?string
bank_state?string
bank_postal_code?string
account_holder_name?string
account_holder_type?string
routing_number?string
iban?string
bic_swift?string
instant_payment?string
instant_payment_type?string
country?string
deposit_reference?string
compliance_status*string
is_active*boolean
autoexchange*boolean
autoexchange_destination_wallet_id?string
created_at*string
Formatdate-time
updated_at*string
Formatdate-time
inactivated_at?string

When the account was inactivated, when applicable.

Formatdate-time
Example Request
curl -X GET 'https://api.betaramps.com/bank-accounts/string'
Example Response
{  "id": "bnk_0192f5a0-1a2b-7c3d-8e4f-5a6b7c8d9e01",  "account_id": "acc_0192f4e0-1a2b-7c3d-8e4f-5a6b7c8d9e01",  "subaccount_id": "sub_0192f4e3-8a9b-7c6d-5e4f-3a2b1c0d9e8f",  "asset": "BRL",  "network": "pix",  "bank_type": "external",  "bank_name": "Banco do Brasil",  "bank_code": "001",  "branch": "0001",  "account": "1234567-8",  "account_holder_name": "Acme Serviços Ltda",  "account_holder_type": "company",  "bank_address": "Av. Paulista 1000",  "bank_city": "São Paulo",  "bank_state": "SP",  "bank_postal_code": "01310-100",  "instant_payment": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",  "instant_payment_type": "evp",  "country": "BR",  "deposit_reference": "Invoice 4471",  "compliance_status": "approved",  "is_active": true,  "autoexchange": false,  "created_at": "2026-10-31T12:00:00Z",  "updated_at": "2026-10-31T12:00:00Z"}

Post Bank Accounts

Previous Page

Delete Bank Accounts By Bank Account Id

Next Page