Skip to main content

Get a Bank Account

One bank account. For what it holds, see Balances of One Bank Account.

New in v3: v2 has no equivalent.

Authorization:

Every request is signed with your API key: a short-lived JWT, signed with your private key, sent in one header on /v3/* and /api/v2/* alike.

Headers:
  Authorization: APIKey {SIGNED_JWT}

How to build and sign the JWT: Authentication.

Endpoint

GET

/v3/bank-accounts/{bank_account_id}

Path parameters​

ParameterTypeDescription
bank_account_idstring (bnk_…)Required. The bank account.

An account-scoped key reads only its own account's bank accounts; another account's reads as 404. A workspace-scoped key reads any bank account of the workspace.

Query parameters​

ParameterTypeDescription
includestringcustomer adds the holder's customer object. A bank account whose account was deleted then reads as 404.

Response Sample​

{
  "id": "bnk_01k8x4m2qv7r3t5w9y1a3c5e7g",
  "customer_id": "cst_01h455vb4pex5vsknk084sn02q",
  "kind": "deposit",
  "name": "Operating",
  "reference": "ODOPX2",
  "account_number": "555000114019",
  "currency": "USD",
  "status": "active",
  "is_default": true,
  "customer": {
    "id": "cst_01h455vb4pex5vsknk084sn02q",
    "name": "Ava Kim",
    "email": "ava.kim@example.com"
  },
  "created_at": "2026-03-02T14:20:11Z",
  "updated_at": "2026-09-18T10:05:42Z"
}

This sample was requested with include=customer.

Response Schema​

The bank account, with the fields of a List Bank Accounts row. This endpoint never returns balance.

Errors​

StatusmessageWhen
400failed to parse requestbank_account_id is not a bnk_… id, or include is not customer.
401unauthorizedMissing or invalid signature.
404bank_account_not_foundNo such bank account, or it belongs to another account.

Support and Resources​

If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.

Stay Updated​

Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:

We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!