Nigeria Uniform Bank Account Number (NUBAN) API Lookup Documentations

Our Nigeria Uniform Bank Account Number (NUBAN) API lookup function allows you to automate NUBAN Lookup by a simple HTTP GET request. For casual user who is not interested to use API, similar function is available in Nigeria Uniform Bank Account Number (NUBAN) page.

The function will return the result in either XML or JSON format. The default format is XML, but if you prefer to have the result in JSON format simply specify JSON format in the request. You can parse both format easily into various programming languages and platforms.

This page will describe on how to use our Nigeria Uniform Bank Account Number (NUBAN) API and the expected result you will receive from our systems.

As part of system security and protection, you require to have an API key in order to access our API function, which will be given once you register for API Access.

How to do Nigeria Uniform Bank Account Number (NUBAN) Lookup through API?


Nigeria Uniform Bank Account Number (NUBAN) Lookup through our API is very simple. What you need to do is make a GET request.

General API Call Format

The default result format is in XML. If you want to get the result in this format, simply follow the API request as below,


https://api.bank.codes/ng-nuban/?format=[FORMAT]&api_key=[API_KEY]&bank=[BANK]&nuban=[NUBAN]

OR
https://api.bank.codes/ng-nuban/[FORMAT]/[API_KEY]/[BANK]/[NUBAN]/

Input DataExplanation
[FORMAT]Specify the format of the output. Accept "xml" or "json"
[API_KEY]API Key assign to your account
[BANK]Bank Code which you would like to check. Refer the list of Bank Code below.
[NUBAN]Nigeria Uniform Bank Account Number (NUBAN) which you would like to check without space or dash.

List of Bank Code

Bank Bank Code
ACCESS BANK 044
ACCESSMOBILE 323
ASO SAVINGS AND LOANS 401
CELLULANT 317
CENTRAL BANK OF NIGERIA 001
CITIBANK 023
CORONATION MERCHANT BANK 559
CORPORETTI 310
COVENANT MICROFINANCE BANK 551
DIAMOND BANK 063
EARTHOLEUM (QIK QIK) 302
ECOBANK NIGERIA 050
ECOMOBILE 307
EKONDO MICROFINANCE BANK 562
ENTERPRISE BANK 084
EQUITORIAL TRUST BANK 040
E-TRANZACT 306
FBN M-MONEY 309
FBN MORTGAGES 413
FETS (MY WALLET) 314
FIDELITY BANK 070
FIDELITY MOBILE 318
FINATRUST MICROFINANCE BANK 608
FIRST BANK OF NIGERIA 011
FIRST CITY MONUMENT BANK 214
FIRST INLAND BANK 085
FORTIS MICROFINANCE BANK 501
FORTIS MOBILE 308
FSDH 601
GT MOBILE MONEY 315
GUARANTY TRUST BANK 058
HEDONMARK 324
HERITAGE BANK 030
IMPERIAL HOMES MORTGAGE BANK 415
INTERCONTINENTAL BANK 069
JAIZ BANK 301
JUBILEE LIFE 402
KEGOW 303
KEYSTONE BANK 082
MAINSTREET BANK 014
MIMONEY (POWERED BY INTELLIFIN) 330
M-KUDI 313
MONETIZE 312
MONEYBOX 325
NEW PRUDENTIAL BANK 561
NPF MFB 552
OCEANIC BANK 056
OMOLUABI SAVINGS AND LOANS 606
ONE FINANCE 565
PAGA 327
PAGE MFBANK 560
PARALLEX 502
PARKWAY (READY CASH) 311
PAYATTITUDE ONLINE 329
PAYCOM 304
PROVIDUS BANK 101
SAFETRUST MORTGAGE BANK 403
SEED CAPITAL MICROFINANCE BANK 609
SKYE BANK 076
STANBIC IBTC BANK 221
STANBIC MOBILE 304
STANDARD CHARTERED BANK 068
STERLING BANK 232
STERLING MOBILE 326
SUNTRUST 100
TEASY MOBILE 319
TRUSTBOND 523
U-MO 316
UNION BANK OF NIGERIA 032
UNITED BANK FOR AFRICA 033
UNITY BANK 215
VFD MICROFINANCE BANK 566
VISUAL ICT 328
VTNETWORK 320
WEMA BANK 035
ZENITH BANK 057
ZENITH MOBILE 322

1. XML Format Example


https://api.bank.codes/ng-nuban/?format=xml&api_key=9fc53b3db09ca830488d19546a4fc2a1&bank=044&nuban=0000014579

OR
https://api.bank.codes/ng-nuban/xml/9fc53b3db09ca830488d19546a4fc2a1/044/0000014579/

Expected Result in XML


<?xml version="1.0" encoding="utf-8"?>
<result>
  <nuban>0000014579</nuban>
  <bank>ACCESS BANK</bank>
  <bank_code>044</bank_code>
  <checksum>9</checksum>
  <valid>true</valid>
</result>

2. JSON Format Example


https://api.bank.codes/ng-nuban/?format=json&api_key=9fc53b3db09ca830488d19546a4fc2a1&bank=044&nuban=0000014579

OR
https://api.bank.codes/ng-nuban/json/9fc53b3db09ca830488d19546a4fc2a1/044/0000014579/

Expected Result in JSON


{
    "nuban": "0000014579",
    "bank": "ACCESS BANK",
    "bank_code": "044",
    "checksum": "9",
    "valid": "true"
}

3. Error Messages

In some cases, the API may return a response containing error message. Below you can find a description of all possible error messages.

Error IDError MessageExplanation
1001API Key Not SpecifiedYou need to specify your API Key while making API request. Kindly check the API Key in user area.
1002Invalid API KeyPlease make sure that you specify the correct API Key assign to your account. Kindly check the correct API Key in the user area.
1003Suspended API KeyYour API Key was suspended due to system abuse. Kindly contact support.
1004API Usage Limit ExceededYou have exceeded the daily limit allocated to your account. You may purchase additional credit in the user area.
1005NUBAN or Bank Not SpecifiedYou need to specify Nigeria Uniform Bank Account Number (NUBAN) and Bank Code you want to check.
1006Invalid NUBAN or BankPlease make sure that you specify Nigeria Uniform Bank Account Number (NUBAN) and Bank Code in the correct format.
1007NUBAN Not ValidThe Nigeria Uniform Bank Account Number (NUBAN) that you submitted has an invalid Control Digit.