stephendache/africa-bank-data

Open dataset of African banks for developers building fintech apps and payment systems. # Africa Bank Data > **Open dataset of African banks for developers building fintech apps and payment systems. ** Africa Bank Data is an open, structured, developer-friendly dataset of banks across African countries. It is designed for fintech products, onboarding flows, payout systems, transfer forms, internal tools, and any application that needs a reliable bank directory. ## Why this project exists Developers building financial products in Africa constantly need to: - show a bank selector in forms and apps - map bank codes to bank names - search institutions consistently - support multiple countries with one schema - enrich bank records with useful metadata such as USSD, website, and support email Most teams rebuild this privately. This project exists to make that dataset open, reusable, and easier to maintain together. ## What this repository includes - country-based datasets in `data/ /banks.json` - country metadata in `data/ /metadata.json` - a top-level country index in `data/index.json` - starter JS SDK in `packages/js-sdk` - starter API in `api/` - validation scripts in `scripts/` - contributor documentation and GitHub templates ## Repository structure ```text africa-bank-data/ ├── .github/ │ ├── ISSUE_TEMPLATE/ │ ├── workflows/ │ └── PULL_REQUEST_TEMPLATE.md ├── api/ ├── assets/ ├── data/ │ ├── EG/ │ ├── GH/ │ ├── KE/ │ ├── NG/ │ ├── RW/ │ ├── ZA/ │ └── index.json ├── docs/ ├── logos/ ├── packages/ │ └── js-sdk/ ├── scripts/ ├── CODE_OF_CONDUCT.md ├── CONTRIBUTING.md ├── LICENSE └── README.md ``` ## Data model ### `data/index.json` Contains the list of supported countries. ### `data/ /metadata.json` Contains basic information about the country dataset. ### `data/ /banks.json` Contains the bank records for one country. ## Bank object schema Each bank object may contain the following fields: - `name` — official institution name - `code` — bank or institution code used locally - `slug` — URL-friendly identifier - ` …