Bank Account

Required Inputs

InputValue

country

NG

id_type

BANK_ACCOUNT

id_number

Bank account number

bank_code

The 3-digit CBN issued code for the bank. The full list of supported banks is listed below.

Response Fields

Response FieldValue Returned

Country

YES

IDType

YES

IDNumber

YES

IssuanceDate

NO

ExpirationDate

N/A

FullName

YES

DOB

VARIES BY BANK

Photo

NO

PhoneNumber

YES

PhoneNumber2

NO

Document

NO

Gender

YES

Address

YES

All fields are returned as string

Response Returned By Each Supported Bank

The response returned on the bank account service varies from bank to bank. The responses returned for all our supported bank is as follows

AccessFull Data ReturnedAccount Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

Diamond Bank

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

Ecobank

Limited Data

Account Name, First Name, Middle Name, Last Name, Account Currency, Address

Fidelity Bank

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

First bank

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

FCMB

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

GTB

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

Heritage Bank

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

Jaiz Bank

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

Keystone Bank

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

Polaris Bank

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

Stanbic

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

Sterling Bank

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

UBA

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

Union

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

Unity Bank

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

Wema

Limited Data

Account Name, First Name, Middle Name, Last Name, Account Currency, Address

Zenith

Full Data Returned

Account Name, First Name, Middle Name, Last Name, Phone No, DOB, Address

ID Number Regular Expression (Regex)

To limit the probability of your user mistyping the id number, we advice that you enforce the format of the id number field in your app. You can use the regex below:

  • /^[0-9]{10}$/

Supported Products

The Nigeria bank account can be used on any of the following products:

For the supported integration options, you can check the integration options supported by each product here.

Sample ID Numbers

To test the Nigeria bank account in our Sandbox, we provide you with 5 different id numbers to mirror various scenarios you can experience with real IDs in production.

ID NumberResultResult Code

0000000000

Success with PII return

1012

0000000001

Failure, no record found

1013

0000000002

Invalid ID number format

1014

0000000003

Database unavailable/unknown network issue

1015

0000000004*

Success with custom PII return

1012

* You can read more about customising the PII response in sandbox in our documentation here.

Bank Codes

BankBank Code

Access Bank

044

Access Bank (Diamond Bank)

063

Ecobank

050

Enterprise Bank

084

Fidelity Bank

070

First Bank

011

First City Monument Bank

214

Guaranty Trust Bank

058

Heritage Bank

030

Jaiz Bank

301

Keystone Bank

082

Mainstreet Bank

014

Polaris Bank

076

Stanbic IBTC

221

Skye Bank

076

Sterling Bank

232

Union Bank

032

UBA

033

Unity Bank

215

Wema Bank

035

Zenith Bank

057

You can fetch all supported banks and their respective codes using {{base_url}}/v2/bank-codes?country=NG

Last updated