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​
| Name | Position | Required | Description |
|---|---|---|---|
| token | Headers | True | app secret key |
| account_number | query | True | user account number |
| bank_code | query | True | institution short code |
---
curl --location --request POST 'https://api.creditchek.africa/v1/identity/verifyData?account_number=1234567890&bank_code=058 \
--header 'token: {{token}}'
---
{
"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
| Item | Value |
|---|---|
| Method | GET |
| Path | /v1/digitalassets/bank/list |
| Authentication | None |
| Request body | None |
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​
| Field | Type | Always present | Description |
|---|---|---|---|
name | string | Yes | Display name of the institution, e.g. Zenith Bank. |
slug | string | Yes | Unique, URL-safe identifier. Use it as a stable key. |
code | string | Yes | Bank code, e.g. 057. Keep it as a string: some codes have leading zeros or letters (035A). |
logo | string | Yes | URL of the bank's logo image. Empty string "" when no logo is available. |
longcode | string | No | Long bank or sort code, e.g. 057150013. Omitted when unknown. |
category | string | Yes | Type of institution. See possible values. |
2. Filter by category​
Query parameter​
| Parameter | Type | Required | Description |
|---|---|---|---|
category | string | No | Return only banks in this category. Without it, all banks are returned. |
Possible values​
Values are lowercase and case-sensitive.
| Value | Meaning | Examples | Count |
|---|---|---|---|
bank | Commercial, merchant and non-interest banks | Access Bank, Zenith Bank, Jaiz Bank, Coronation Merchant Bank | 39 |
psb | Payment service banks | MTN Momo PSB, HopePSB, 9mobile 9PSB | 5 |
mfb | Microfinance banks, including digital banks | Kuda Bank, VFD, FairMoney MFB, Rubies MFB | 190 |
mortgage | Mortgage banks and savings and loans | Abbey Mortgage Bank, ASO Savings and Loans | 21 |
other | Fintech wallets, finance companies and other payment providers | PalmPay, OPay, Paga, Credit Direct | 31 |
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"
}
]