Retrieve a bank account

Operation ID: getBankAccount

Group: Banking › Bank Accounts

Open in the interactive reference

GET /banking/bank-accounts/{id}

Read-only: Reads and returns; changes nothing.

Retrieves a bank account. The response includes the bank account's full payment details: reference, bankAccountCode, and bankAccountHolderName. Show mask where the full account number isn't needed.

A bank account deleted with DELETE banking/bank-accounts/:id isn't returned, and the request fails with NOT_FOUND.

Parameters

Name In Type Required Description
Api-Version header string · v1 yes The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version v1.
id path string yes The unique identifier of the bank account you want to retrieve. Example: "d5397c8b-6d2b-47e9-83a3-712d9180711e".

Response

200 Success

Under data (getBankAccountOutput):

Field Type Required Description
id string yes The unique identifier for the bank account.
externalAccountId string yes The identifier this account has in the bank or aggregator it was connected from. Unique within the tenant.
externalAccountName string no The account name as reported by the bank or aggregator.
externalDescription string no The account description as reported by the bank or aggregator.
type string no The kind of account, as free-form text. For example 'checking', 'saving' or 'creditCard'.
currency string no The currency the account is held in. Format ISO 4217, for example 'USD'. balance is in this currency.
balance decimal no The current account balance, in currency.
mask string no A masked form of the account number, for example '****1234'. Display it instead of reference where the full number is not needed.
reference string no The full account number, the IBAN or the ACH account number.
referenceType string no How referenceNumber is structured. Possible values: 'QRR', 'SCOR', 'NON'. 'QRR' is a Swiss QR reference, 'SCOR' an ISO 11649 creditor reference, and 'NON' none.
referenceNumber string no A structured payment reference for payments to this account, interpreted per referenceType.
bankAccountCode string no The bank identifier, the SWIFT/BIC code or the US routing number.
bankAccountHolderName string no The name the account is held in. This is personal data.
paymentAllowed boolean yes Whether payments may be made from this account.
receivableAccount boolean no Whether this account may be used to receive money.
payableAccount boolean no Whether this account may be used to pay money out.
isReady boolean no Whether the account is fully set up and usable.
reconciliationStartDate date yes The date from which this account is reconciled. Format YYYY-MM-DD. Transactions before it are not reconciled.
transactionsImportDate date no The date from which transactions are imported for this account. Format YYYY-MM-DD.
accountId string no The chart-of-accounts account this bank account is linked to. See id on GET accounting/accounts/:id.
accountName string no The name of the linked chart-of-accounts account.
accountNumber string no The number of the linked chart-of-accounts account. This is a general-ledger account number, not the bank account number, which is reference.
bankName string no The name of the bank this account is held at.
financialInstitutionId string no The financial institution this account is held at. There is no endpoint for it.
entityId string no The legal entity that owns this account. See id on GET base/entities.
entityName string no The name of the legal entity that owns this account.
lastModifiedDate date-time yes The date and time the bank account last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ. 
{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "externalAccountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "externalAccountName": "<externalAccountName>",
    "externalDescription": "<externalDescription>",
    "type": "<type>",
    "currency": "<currency>",
    "balance": "19.99",
    "mask": "<mask>",
    "reference": "<reference>",
    "referenceType": "<referenceType>",
    "referenceNumber": "<referenceNumber>",
    "bankAccountCode": "<bankAccountCode>",
    "bankAccountHolderName": "<bankAccountHolderName>",
    "paymentAllowed": true,
    "receivableAccount": true,
    "payableAccount": true,
    "isReady": true,
    "reconciliationStartDate": "2026-01-15",
    "transactionsImportDate": "2026-01-15",
    "accountId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "accountName": "<accountName>",
    "accountNumber": "<accountNumber>",
    "bankName": "<bankName>",
    "financialInstitutionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "entityName": "<entityName>",
    "lastModifiedDate": "2026-01-15T09:30:00.000Z"
  },
  "diagnostics": [
    {
      "code": "<code>",
      "message": "<message>",
      "severity": "error",
      "path": [
        "<path>"
      ],
      "details": "<details>"
    }
  ]
}

Errors

Code Status
NOT_FOUND 400

Statuses