BolajiOlajide
ng-banks
TypeScript

Lightweight Zero dependency npm package to get list of banks in Nigeria (Recognized by CBN)

Last updated Mar 6, 2026
51
Stars
29
Forks
4
Issues
0
Stars/day
Attention Score
41
Language breakdown
TypeScript 100.0%
Files click to expand
README

NG-BANKS

NPM npm version Build Status

NG-BANKS is a lightweight zero-dependency npm package that can be used to get the list of banks in my great country, Nigeria.

Installation

> npm install ng-banks --save

Usage

The package is very simple and as of the time of writing has only one method which is to get a list of banks, their corresponding shortcode and their USSD code.

The list of banks contains all banks recognized by the Central Bank of Nigeria (CBN).

Now that we've gotten this out of the way here's an example

const ngBanks = require('ng-banks');

const banks = ngBanks.getBanks();

// get bank by slug or code console.log(ngBanks.getBank('EBN')); // { name: 'ECOBANK NIGERIA PLC', code: '050', slug: 'EBN', ussd: {code: '*326#' } } console.log(ngBanks.getBank('063')); // { name: 'ACCESS(DIAMOND) BANK PLC', code: '063', slug: 'DMB', ussd: {code: '*710#' } }

ngBanks.getBank('EBN', function(err, bank) { console.log(err, bank); // { name: 'ECOBANK NIGERIA PLC', code: '050', slug: 'EBN', ussd: {code: '*326#' } } }); ngBanks.getBank('063', function(err, bank) { console.log(err, bank); // { name: 'ACCESS(DIAMOND) BANK PLC', code: '063', slug: 'DMB', ussd: {code: '*710#' } } });

CONTRIBUTORS

See also the list of contributors who have contributed to this project.

License

MIT

🔗 More in this category

© 2026 GitRepoTrend · BolajiOlajide/ng-banks · Updated daily from GitHub