Skip to main content

Bank Account Number Verification (Advanced)

POST: https://api.creditchek.africa/v1/identity/verifyData?account_number=01862757&bank_code=058
Sample request account_number: 1234567890 and 9876543210

Request Parameters​

NamePositionRequiredDescription
tokenHeadersTrueapp secret key
account_numberqueryTrueuser account number
bank_codequeryTrueinstitution short code
Example Request
---
curl --location --request POST 'https://api.creditchek.africa/v1/identity/verifyData?account_number=1234567890&bank_code=058 \
--header 'token: {{token}}'
---
Response
{
"status": true,
"data": {
"_id": "62c44dac471f088c5d2f498b",
"account_number": "1234567890",
"businessId": "6287757348cc6c0013f4d0a0",
"__v": 0,
"account_currency": "",
"account_name": "Joshua Doe",
"account_type": "",
"address_1": "35 John Ebu Str Isawo Agric Ikorodu",
"country_of_birth": "Nigeria",
"country_of_issue": "Nigeria",
"createdAt": "2022-07-05T14:41:49.283Z",
"dob": "1999-02-18",
"email": "",
"first_name": "Joshua",
"gender": "Male",
"identity_number": "223538299202",
"identity_type": "BVN",
"last_name": "Doe",
"lga_of_origin": "Oshimili North",
"lga_of_residence": "Ikorodu",
"marital_status": "Single",
"nationality": "Nigeria",
"other_names": "Ikechukwu",
"phone": "07053761455",
"state_of_origin": "Delta State",
"state_of_residence": "Lagos State",
"updatedAt": "2022-07-06T10:04:00.644Z",
"verification": {
"status": "VERIFIED",
"reference": "45ca76e9-94c5-471f-83c3-65a2c4bb9fbd"
},
"photo": "https://res.cloudinary.com/creditchek-africa/image/upload/v1657032204/bvnData/ds2qx9d993gublhjoely.jpg",
"bank_code": "058"
},
"message": "successful",
"error": false
}

Reference to use the Bank List API

Returns every Nigerian bank and financial institution we support, each with its bank code and logo URL. Use it to build bank dropdowns, account-linking screens and payout forms.

The list covers commercial, merchant and non-interest banks, payment service banks, microfinance banks, mortgage banks and fintech wallets. It currently holds 286 institutions.

1. Get all banks​

Request​

GET {baseUrl}/v1/digitalassets/bank/list
ItemValue
MethodGET
Path/v1/digitalassets/bank/list
AuthenticationNone
Request bodyNone
curl "{baseUrl}/v1/digitalassets/bank/list"

Response​

200 OK with a JSON array of bank objects. The array is not wrapped in an envelope.

[
{
"name": "Access Bank",
"slug": "access-bank",
"code": "044",
"logo": "https://nigerianbanks.xyz/logo/access-bank.png",
"longcode": "044150149",
"category": "bank"
},
{
"name": "Zenith Bank",
"slug": "zenith-bank",
"code": "057",
"logo": "https://nigerianbanks.xyz/logo/zenith-bank.png",
"longcode": "057150013",
"category": "bank"
}
]

Response fields​

FieldTypeAlways presentDescription
namestringYesDisplay name of the institution, e.g. Zenith Bank.
slugstringYesUnique, URL-safe identifier. Use it as a stable key.
codestringYesBank code, e.g. 057. Keep it as a string: some codes have leading zeros or letters (035A).
logostringYesURL of the bank's logo image. Empty string "" when no logo is available.
longcodestringNoLong bank or sort code, e.g. 057150013. Omitted when unknown.
categorystringYesType of institution. See possible values.

2. Filter by category​

Query parameter​

ParameterTypeRequiredDescription
categorystringNoReturn only banks in this category. Without it, all banks are returned.

Possible values​

Values are lowercase and case-sensitive.

ValueMeaningExamplesCount
bankCommercial, merchant and non-interest banksAccess Bank, Zenith Bank, Jaiz Bank, Coronation Merchant Bank39
psbPayment service banksMTN Momo PSB, HopePSB, 9mobile 9PSB5
mfbMicrofinance banks, including digital banksKuda Bank, VFD, FairMoney MFB, Rubies MFB190
mortgageMortgage banks and savings and loansAbbey Mortgage Bank, ASO Savings and Loans21
otherFintech wallets, finance companies and other payment providersPalmPay, OPay, Paga, Credit Direct31

Counts change as institutions are added.

An unknown value is not an error: the endpoint returns 200 OK with an empty array [].

Request​

GET {baseUrl}/v1/digitalassets/bank/list?category=psb
curl "{baseUrl}/v1/digitalassets/bank/list?category=psb"

Response​

200 OK with only the banks in that category, in the same format as Get all banks.

[
{
"name": "9mobile 9Payment Service Bank",
"slug": "9mobile-9payment-service-bank-ng",
"code": "120001",
"logo": "https://nigerianbanks.xyz/logo/9mobile-9payment-service-bank.png",
"longcode": "120001",
"category": "psb"
},
{
"name": "Airtel Smartcash PSB",
"slug": "airtel-smartcash-psb-ng",
"code": "120004",
"logo": "https://nigerianbanks.xyz/logo/airtel-smartcash-psb.png",
"longcode": "120004",
"category": "psb"
}
]