Ibrahist/e-mtaa

Pincode lookup API for autofill regions and districts from Tanzania during checkout. # 🇹🇿 Tanzania Pincode Lookup API > ## 🟩 **This project is 100% complete** 🎉 > > `████████████████████████████████████████ 100%` A lightweight **FastAPI** service for looking up Tanzanian regions, cities, and districts from a 6-digit pincode. The API is designed for applications such as **e-commerce checkout forms**, where a customer enters a pincode and the corresponding location information can be automatically populated. ## ✨ Features * 🔎 Look up a location using a 6-digit pincode * 📦 Perform bulk pincode lookups * 🇹🇿 Tanzania-focused location data * ✅ Automatic pincode validation using Pydantic * ⚡ Fast API powered by FastAPI * 🛡️ Custom error handling for invalid and unknown pincodes * 📚 Interactive API documentation through FastAPI * 🧩 Easy to integrate with checkout and address forms ## 🛠️ Tech Stack * **Python** * **FastAPI** * **Pydantic** * **Uvicorn** ## 📁 Project Structure ```text 🇹🇿 EMTAA — Tanzania Pincode Lookup API │ ├── 📁 Scripts/ │ └── ⚙️ Supporting / utility scripts │ ├── 📄 main.py │ └── 🚀 FastAPI application entry point │ ├── API routes │ ├── Pincode lookup │ ├── Bulk lookup │ └── Request / response handling │ ├── 📄 models.py │ └── 🧩 Pydantic data models │ ├── Request schemas │ ├── Response schemas │ └── Data validation │ ├── 📄 data.py │ └── 🇹🇿 Tanzania pincode/location dataset │ ├── Regions │ ├── Cities │ └── Districts │ ├── 📄 exceptions.py │ └── ⚠️ Custom API exceptions │ ├── Invalid pincode │ ├── Pincode not found │ └── Validation errors │ ├── 📄 requirements.txt │ └── 📦 Python dependencies │ ├── FastAPI │ ├── Pydantic │ └── Uvicorn │ ├── 📄 README.md │ └── 📚 Project documentation │ ├── Features │ ├── Installation │ ├── API usage │ └── Examples │ ├── 📄 .gitignore │ └── 🚫 Ignored files / directories │ └── 📄 pyvenv.cfg └── 🐍 Python virtual-environment configuration ┌─────────────────────────┐ │ Cli …