Skip to main content
POST
Match a BVN to a bank account

Authorizations

X-API-Key
string
header
required

Your API key, sent in the "X-API-Key" header. Every endpoint needs the key and the secret together; a request carrying only one of the pair is rejected with 401.

X-API-Secret
string
header
required

Your API secret, sent in the "X-API-Secret" header alongside the API key on every request.

Body

application/json

BVN plus the account to match it against

accountNumber
string
required

10-digit NUBAN of an account belonging to the BVN holder.

Example:

"0123456789"

bankCode
string
required

CBN bank code for that account.

Example:

"058"

bvn
string
required
Example:

"22222222222"

Response

OK

data
object
success
boolean
Example:

true