Skip to main content
POST
Verify a bank account

Overview

Resolves an account number at a bank to the account holder’s name. Show the name to whoever is paying before you send: a wrong bank_code or a mistyped account number is refused here, rather than after the money has moved. bank_code must come from List banks for the same country_code. For Nigerian accounts the answer also carries bank_status: how transfers to that bank are going right now, or null when we don’t know. It is the same object Bank network status returns. If it is red or amber, tell your customer and let them decide; it never blocks the payout.

Authorizations

X-API-Key
string
header
required

API key for authentication.

Body

application/json
account_number
string
required
Example:

"0123456789"

bank_code
string
required

From the bank list

Example:

"044"

country_code
string
required
Example:

"NG"

Response

Account resolved

status
boolean
data
object
error
any[]
message
string