MurageKabui/KPLC-Tokens-LookUp-Tool

Unofficial web tool and API for accessing Kenya Power (KPLC) prepaid token purchase history. Features a Public REST API for developers. KPLC Token Lookup Tool An Open API for retrieving Kenya Power (KPLC) prepaid token purchase history and insights > ⚠️ **DISCLAIMER**: This project is **not affiliated with, endorsed by, or connected to** Kenya Power and Lighting Company (KPLC). > It exists for educational and utility purposes only. - Full walkthrough, including the interception methodology, is available at : blog.denniskabui.com - Web interface: denniskabui.com - API reference: denniskabui.com ## Overview A self hosted web interface and public API for retrieving Kenya Power (KPLC) prepaid token purchase history and transaction insights. Through analysis of the official KPLC Android application's network interactions, this project provides an accessible REST API and interactive dashboard for meter token data. ## Features - Retrieve full token purchase history for a given meter number - Cost and unit breakdown per transaction - AI-powered break down of cost components - Public REST API for integrations - Browser persistence for saved meter numbers - Responsive UI suitable for desktop and mobile ## API Reference ### Base URL ``` denniskabui.com ``` ### 1. Get Token History Returns a list of historical token transactions for a specific meter. **Endpoint** ``` GET /api/tokens/:meter ```` - `meter` - String (required): - Prepaid meter number (e.g., `54601446543`) **Example Request** ```bash curl -X GET "denniskabui.com" \ -H "Accept: application/json" ```` **Example Response** ```json { "success": true, "data": [ { "trnTimestamp": 1709280000000, "trnAmount": "500.00", "trnUnits": "18.50", "tokenNo": "1234-5678-9012-3456-7890", "recptNo": "RCT123456", "pMethod": "Cash", "concepts": [ { "codConcept": "RESSTEP0", "amount": 300.00 }, { "codConcept": "RESSTEP0TAX", "amount": 80.00 } ] } ] } ``` …