mosesniyonk/rwandapi

A free public REST API for Rwanda — provinces, districts, sectors, cells, exchange rates, utility tariffs, and more. # rwandapi A free, open-source REST API serving Rwanda data — administrative divisions, banks, telecoms, mobile money, emergency numbers, holidays, and more. No API key required. No rate-limit gotchas. Just clean JSON. ## Base URL ``` rwandapi.onrender.com ``` For local development: `localhost` ## Endpoints ### Geography | Method | Endpoint | Description | |--------|----------|-------------| | `GET` | `/api/v1/provinces` | List all 5 provinces | | `GET` | `/api/v1/provinces/:id` | Single province with its districts | | `GET` | `/api/v1/districts` | List all 30 districts (filter: `?province_id=`) | | `GET` | `/api/v1/districts/:id` | Single district with its sectors | | `GET` | `/api/v1/sectors` | List all 416 sectors (filter: `?district_id=`) | | `GET` | `/api/v1/sectors/:id` | Single sector with its cells | | `GET` | `/api/v1/cells` | List all 2,149 cells (filter: `?sector_id=`) | | `GET` | `/api/v1/cells/:id` | Single cell with its villages | | `GET` | `/api/v1/villages` | List all 14,837 villages (filter: `?cell_id=`) | | `GET` | `/api/v1/search?q=kimironko` | Search across all geographic entities | ### Finance | Method | Endpoint | Description | |--------|----------|-------------| | `GET` | `/api/v1/banks` | List 10 banks with 129 branches, SWIFT codes, contacts | | `GET` | `/api/v1/banks/:id` | Single bank with all its branches | | `GET` | `/api/v1/exchange-rates` | BNR exchange rates for 18 currencies against RWF | | `GET` | `/api/v1/mobile-money` | Mobile money services (MoMo, Airtel Money) with fee schedules | | `GET` | `/api/v1/mobile-money/:id` | Single service with fees and limits | ### Telecoms & ISPs | Method | Endpoint | Description | |--------|----------|-------------| | `GET` | `/api/v1/telecoms` | List all telecom providers and ISPs (filter: `?type=mobile` or `?type=isp`) | | `GET` | `/api/v1/telecoms/:id` | Single provider with plans and USSD codes | ### Utilities | Method | Endpoint | Description | |--------|----- …