A RESTful api that provides demographic data for mozambique
# Moz-Demog-API
> 📘 Para ler em português, clique aqui
**Moz-Demog-API** is a public RESTful API that provides **Mozambique's demographic data from 2017 to 2026**, delivered in standard JSON format.
It was built to support:
- Developers building data-driven applications
- Programming students practicing API consumption
- Data scientists performing population analysis
- Anyone with technical knowledge who needs access to structured demographic data
All datasets are sourced from the official **National Institute of Statistics of Mozambique (INE)**.
📄 **API Documentation**:
You can view and interact with the documentation at
👉
moz-demog-api.vercel.app
---
## 📦 Tech Stack & Tools
**Languages & Frameworks**
- HTML, CSS, JavaScript
- Node.js, Express.js
**Data & Modeling**
- PostgreSQL
- PlantUML (for diagrams)
**Tooling**
- Visual Studio Code
- Postman
---
## 🗂 Endpoints Overview (English)
| Resource | Endpoint | Method |
|--------------|------------------------------------------|--------|
| Country Data | `/country` | GET |
| Provinces | `/province-info` | GET |
| Districts | `/province-info/list` | GET |
| Indicators | `/indicators/` | GET |
For full parameter details and example responses, visit the documentation.
---
## 📌 Limitations
- Province level data is only available for **2023**
- Write operations (POST, PUT, DELETE) are **not supported** in the current version
---
## 🤝 Contact
For suggestions, issues, or collaborations, feel free to reach out:
📫 Email: therakius.dev@gmail.com
---
Developed by therakius .