Verify a bank account

Checks that a US bank account exists and is open, from its routing number and account number. Use it at onboarding, before you pay out to a merchant or debit their account. The answer comes back in the same response.

Coris treats Open Valid and Valid Pattern as a pass. Treat any other verification_status as a reason to ask the merchant for another account, or to review it by hand:

verification_statusMeaning
Open ValidThe account is open and in good standing.
Valid PatternThe numbers have a valid format for this bank, but the bank has no history for the account yet.
Closed InvalidThe account is closed or not valid.
Invalid PatternThe account number does not have a valid format for this bank.
No Information FoundThe bank has no data for this account.
Debit Return LikelyA debit to this account is likely to be returned.

The bank can also return Notification of Change Received, Debit Unsuccessful, Payment Rejected, Payment Instruction Error, Request Rejected or Unable to Determine.

Coris keeps each result for 7 days. A repeat request for the same account in that time returns the saved result with the same last_verified_at. Send force_refresh: true to run a fresh check.

In the sandbox the results are simulated. The same account number always returns the same status.

To also check that the account belongs to the merchant, use Authenticate a bank account.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

The account to check.

string
required

The bank account number.

string
required

The bank's 9-digit ABA routing number.

string
required

The type of clearing_system_id. Send ABA for a US routing number.

boolean
Defaults to false

If true, run a fresh check instead of returning a result saved in the last 7 days. Defaults to false.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html