Skip to main content
Retrieve a single bank account by its ID. Use this endpoint to check the current verification status of an account, inspect micro-deposit timestamps, or fetch account metadata before initiating a payment.

​
HTTP Request

​
Authentication

Include your bearer token on every request:

​
Path Parameters

​
bankAccountId
string
required
The unique identifier of the bank account to retrieve. This is the id returned when the account was created, or from the list accounts response.

​
Response Fields

​
id
string
required
Unique identifier for the bank account.
​
status
string
required
Current verification status of the account. One of:
  • pending_verification — micro-deposits have been initiated and are awaiting confirmation.
  • verified — account is verified and ready to use for payments.
  • unverified — verification failed because the maximum number of attempts was exceeded.
  • removed — account has been deleted.
​
type
string
required
The bank account type: checking or savings.
​
connectionType
string
required
How the account was connected. Either manual (linked via the API) or plaid. The API only creates manual accounts.
​
name
string | null
The display name assigned to this account.
​
institutionName
string | null
The name of the financial institution.
​
accountNumberLast4
string | null
The last four digits of the account number.
​
routingNumberLast4
string | null
The last four digits of the routing number.
​
isDefault
boolean
required
Whether this account is the default account for your business.
​
microDepositsInitiatedAt
datetime | null
The timestamp at which micro-deposits were initiated, or null if not yet started.
​
microDepositsCompletedAt
datetime | null
The timestamp at which micro-deposits landed in the account. Verification can be attempted once this field is non-null.
​
verificationAttempts
number
required
The number of failed verification attempts made so far. The maximum is 3; exceeding it sets the account status to unverified.

​
Example Request

​
Example Response

Poll this endpoint (or listen for bank_account.* webhooks) to track when microDepositsCompletedAt becomes non-null. Once deposits have landed, prompt the account holder to submit the two deposit amounts via the verify micro-deposits endpoint.