BD APIs

BD API is a powerful REST API service that provides comprehensive location data for Bangladesh. It includes Divisions, Districts, Upazilas, Thanas, Post Offices, and Post Codes — all available in both English and Bangla.

v1.x is open-source (MVP) and will remain free forever. The project is built with modern technologies and is actively maintained.

Key Features

Complete Bangladesh administrative hierarchy (Division → District → Upazila → Thana → Post Office)
Bilingual support (English + Bangla)
Fast and reliable endpoints
Available on RapidAPI marketplace
Docker support for easy deployment
MongoDB + Prisma schema support
Public documentation at bdapis.com

Tech Stack

Backend: Node.js + Express.js
Database: MongoDB (with Mongoose & Prisma)
Deployment: Docker, Heroku, Cyclic
Languages: JavaScript, EJS, Shell, CSS

Getting Started

git clone https://github.com/AbmSourav/bdapis.git
cd bdapis
cp .env-example .env
# Add your MongoDB credentials in .env
npm install
npm run dev

Using Docker (Recommended)

docker-compose up -d --build

Example Usage