Skip to main content

Bank Account Verification

Verify Bank Account

Returns a status indicating that bank account information is valid for receiving transactions.

POST
https://api.basistheory.com/enrichments/bank-account-verify
Copy

Permissions

token:use

Request

Using “bank“ token type
curl --location 'https://api.basistheory.com/enrichments/bank-account-verify' \
--header 'BT-API-KEY: <API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"token_id":"5dae2960-8d7d-11ef-806c-1b5325d52a83",
"country_code": "US"
}'
Using “us_bank_account_number“ token type
curl --location 'https://api.basistheory.com/enrichments/bank-account-verify' \
--header 'BT-API-KEY: <API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"token_id":"5dae2960-8d7d-11ef-806c-1b5325d52a83",
"country_code": "US",
"routing_number": "021000021"
}'

Request Parameters

NameTypeDescription
token_idStringThe ID of the token containing the bank information. Token type must be either bank or us_bank_account_number.
country_codeString (Optional)The two character ISO country code. Default: US
routing_numberString (Optional)The routing number of the bank account. Only applicable if the token referenced by token_id is of type us_bank_account_number

Response

Returns the status of the bank account. If the status is enabled, then the bank account is available to receive ACH transactions. When the status is disabled, then the bank account is either closed or could not be found. Disabled accounts are not available to receive ACH transactions.

{
"status": "enabled"
}
NameTypeDescription
statusStringEither enabled or disabled