Retrieve a bank account

Retrieve bank account details (i.e. routing number or account type) associated with a specific Moov account.

To use this endpoint from the browser, you’ll need to specify the /accounts/{accountID}/bank-accounts.read scope when generating a token.
GET
/accounts/{accountID}/bank-accounts/{bankAccountID}
200 404 429
Successfully retrieved bank account.
Describes a bank account on a Moov account.
{
  "bankAccountID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
  "bankAccountType": "checking",
  "bankName": "Chase Bank",
  "exceptionDetails": {
    "achReturnCode": "R02",
    "description": "string"
  },
  "fingerprint": "9948962d92a1ce40c9f918cd9ece3a22bde62fb325a2f1fe2e833969de672ba3",
  "holderName": "Jules Jackson",
  "holderType": "individual",
  "lastFourAccountNumber": "7000",
  "routingNumber": "string",
  "status": "new",
  "statusReason": "bank-account-created",
  "updatedOn": "2019-08-24T14:15:22Z"
}
No account with the specified accountID was found.
Request was refused due to rate limiting.

X-Retry-In

string <duration>
How long (in milliseconds) to wait until able to retry the request.

Path parameters

accountID

string <uuid> required
ID of the account.

bankAccountID

string <uuid> required
ID of the bank account

Response

application/json
Describes a bank account on a Moov account.

bankAccountID

string<uuid> <=36 characters Pattern
UUID v4

bankAccountType

string<enum>
The bank account type.
Possible values: checking, savings, unknown

bankName

string

exceptionDetails

object
Reason for, and details related to, an errored or verificationFailed bank account status.
right_key Show child attributes

achReturnCode

string<enum>
The return code of an ACH transaction that caused the bank account status to change.
Possible values: R02, R03, R04, R05, R07, R08, R10, R11, R12, R13, R14, R15, R16, R17, R20, R23, R29, R34, R38, R39

description

string
Details related to an errored or verificationFailed bank account status.

fingerprint

string <=100 characters
Once the bank account is linked, we don’t reveal the full bank account number. The fingerprint acts as a way to identify whether two linked bank accounts are the same.

holderName

string

holderType

string<enum>
The type of holder on a funding source.
Possible values: individual, business

lastFourAccountNumber

string

routingNumber

string

status

string<enum>
The bank account status.
Possible values: new, verified, verificationFailed, pending, errored

statusReason

string<enum>
The reason the bank account status changed to the current value.
Possible values: bank-account-created, verification-initiated, micro-deposit-attempts-exceeded, micro-deposit-expired, max-verification-failures, verification-successful, ach-debit-return, ach-credit-return, micro-deposit-return, admin-action, other

updatedOn

string<date-time> <=24 characters