Dechateau2035/afriphone

The Phone Intelligence API for Africa — detect mobile operator, country and Mobile Money routing for any African phone number. AfriPhone API The Phone Intelligence API built for Africa. Detect mobile operator, country, and Mobile Money routing for any African phone number — in milliseconds. 🌍 Live Demo  ·  API Reference  ·  Documentation  ·  Pricing --- ## What is AfriPhone? AfriPhone is a **REST API** that gives you instant intelligence on any African phone number — no matter what format it's in. You pass a number, you get back: - 🌍 The **country** it belongs to - 📡 The **mobile operator** (MTN, Orange, Airtel, Safaricom, Wave, Glo…) - 💸 Whether **Mobile Money** is enabled and **which service** to charge (MTN MoMo, Orange Money, M-Pesa, Wave…) - ✅ The canonical **E.164 normalised** form ready for any pipeline It ships as a full-stack monorepo: a **NestJS REST API** backed by PostgreSQL, and a **Next.js 15** web portal with dashboard, documentation, and a live interactive playground. --- ## ✨ Features ### 🔌 API | Feature | Description | |---------|-------------| | **Phone Lookup** | Full intelligence: operator, country, MoMo routing code, E.164, national format | | **Validate & Normalise** | Clean raw numbers to E.164 from any format with optional country hint | | **Bulk Validation** | Up to 100 numbers per request (Free/Starter: ≤10, Pro: ≤100) | | **Mobile Money Routing** | Returns the exact service code to charge: `MTN_MOMO_CM`, `ORANGE_MONEY_SN`, `MPESA_KE`… | | **Operator Reports** | Community-driven corrections — 3 reports on the same number trigger an internal alert | | **Usage Statistics** | Per-key quota, call count, reset date, and 30-entry activity log | | **Rate Limit Headers** | Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` | | **Request IDs** | Traceable `X-Request-Id` on every response | | **Demo Endpoint** | `GET /demo/lookup/:number` — live data, no API key, throttled 10 req/min | | **Swagger / OpenAPI** | Interactive docs at `/api-docs` | | **Prefix Sync Cron** | Scheduled j …