Bank Account

Required Inputs

Input	Value
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 Field	Value 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

Access	Full Data Returned	Account 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:

• Basic KYC

• Enhanced KYC

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 Number	Result	Result 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

Bank	Bank 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