Skip to content

liciolentimo/kenya-api

Repository files navigation

KenyaAPI

Free, open REST API for Kenya's public data — no API key required.

🔗 Live API: https://kenya-api.netlify.app/
📖 Interactive Docs: https://kenya-api.netlify.app/docs.html
📚 Full Documentation: GitHub Wiki

Code of Conduct


What is KenyaAPI?

KenyaAPI consolidates Kenya's public data into one consistent, developer-friendly REST API — no authentication required.

Resource Count
Counties 47
Constituencies 290
Wards 1,263
Lakes 18
Rivers 12
Parks & Reserves 35
Institutions 700+
Parastatals 246
Ministries 22
Presidents 5
Exchange Rates 25 (live)
Postal Codes 47 counties

👉 For the complete endpoint reference, parameters, and example responses for every resource, see the GitHub Wiki.


Quick Start

curl https://kenya-api.netlify.app/api/v1/counties

Response:

{
  "success": true,
  "count": 47,
  "data": [ ... ]
}

No API key. No authentication. Rate limited to 100 requests/minute per IP. See Rate Limiting for details.


Tech Stack

  • Node.js + Express
  • JSON data files (no database)
  • Hosted on Netlify (static frontend + serverless functions)

Local Development

git clone https://github.com/liciolentimo/kenya-api.git
cd kenya-api
npm install
node server.js

Server runs on http://localhost:3000. See CLAUDE.md for project structure and coding conventions.


Documentation

Where What
Interactive Docs Live, runnable code examples in 7 languages
GitHub Wiki Full endpoint reference, parameters, data models
CLAUDE.md Project structure and conventions for contributors

Contributing

Contributions are welcome! Please read the Code of Conduct first.

See Contributing Guide on the wiki for the full workflow and data standards.


Data Sources

KenyaAPI aggregates verified public data from IEBC, KNBS, Central Bank of Kenya, Office of the President, CUE, TVETA, Kenya Wildlife Service, and other official and openly licensed sources. Full breakdown: Data Sources on the wiki.


Support

Built and maintained by Licio Lentimo
🌐 liciolentimo.com
Support this project

About

A free, open REST API for developers building with Kenyan public data — counties, constituencies, public holidays, population statistics, and live exchange rates.

Topics

Resources

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors