Retrieve a bank 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}
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",
"rtpRejectionCode": "AC03 - Account Invalid"
},
"fingerprint": "9948962d92a1ce40c9f918cd9ece3a22bde62fb325a2f1fe2e833969de672ba3",
"holderName": "Jules Jackson",
"holderType": "individual",
"lastFourAccountNumber": "7000",
"paymentMethods": [
{
"paymentMethodID": "9506dbf6-4208-44c3-ad8a-e4431660e1f2",
"paymentMethodType": "ach-debit-fund"
},
{
"paymentMethodID": "3f9969cf-a1f3-4d83-8ddc-229a506651cf",
"paymentMethodType": "ach-debit-collect"
}
],
"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.
Response headers
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
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.
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.
rtpRejectionCode
string<enum>
The rejection code of an RTP transaction that caused the bank account status to change.
Possible values:
AC03 - Account Invalid,
AC04 - Account Closed,
AC06 - Account Blocked,
AC14 - Creditor Account Type Invalid,
AG01 - Transactions Forbidden On Account,
AG03 - Transaction Type Not Supported,
MD07 - Customer Deceased
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
paymentMethods
array
Includes any payment methods generated for a newly created bank account, removing the need to call the List Payment Methods endpoint following a successful Create BankAccount request.
NOTE: This field is only populated for Create BankAccount requests made with the X-Wait-For header.
Show child attributes
paymentMethodID
string<uuid>
<=36 characters
Pattern
UUID v4
paymentMethodType
string<enum>
The payment method type that represents a payment rail and directionality
Possible values:
moov-wallet,
ach-debit-fund,
ach-debit-collect,
ach-credit-standard,
ach-credit-same-day,
rtp-credit,
card-payment,
apple-pay,
push-to-card,
pull-from-card
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,
rtp-credit-failure,
micro-deposit-return,
admin-action,
other
updatedOn
string<date-time>
<=24 characters