📢 New API version v1.2 has been released. Previous versions 1.0 and 1.1 has been deprecated.

BD API is a RestAPI service. Developed by Keramot UL Islam. Divisions, Districts, Upazilla, Thana, Post Office, Post Code etc of Bangladesh are available in Bangla and English within endpoints.

v1.x is a MVP of this project and also open-source and v1.x will always remain open-source. Do you wanto to become Sponsor/Investor for full project? Contact Here.

Documentation

Base URL: https://bdapis.com

Namespace: /api

API Version: /v1.2

#Rest API

v1.x Routes

available
Select Version

#Postman Documentation

Find more information in the Postman Documentation Here.

v2.x Routes

not available
Route: /division/:divisionName
All Districts, Upazilla, Thana, Post Office, Post Code of the given Division
                                district: object {en: String, bn: String}
								coordinates: String
                                upazilla: object {en: String, bn: String}
                                thana: object {en: String, bn: String}
                                post: object { postOffice: {en: String, bn: String}, postCode: {en: Number, bn: Number} }
                            
Route: /district/:districtName
All Upazilla, Thana, Post Office, Post Code of the given District
                                upazilla: object {en: String, bn: String}
                                thana: object {en: String, bn: String}
                                post: object { postOffice: {en: String, bn: String}, postCode: {en: Number, bn: Number} }
                            
Route: /upazilla
All Upazilla
                                upazilla: String
                                upazillabn: String
                            
Route: /thana
All Thana
                                thana: String
                                thanabn: String
                            
Route: /postOffice
All Post Office, Post Codes
                                postOffice: String
                                postOfficebn: String
                                postCode: String
                                postCodebn: String
                            

# Examples

Route:
https://bdapis.com/api/v1.2/divisions
						
{
	"status": {
		"code": 200,
		"message": "ok",
		"date": "Wed, 12 May 2021 05:39:36 GMT"
	},
	"data": [
		{
			"division": "Barishal",
			"divisionbn": "বরিশাল",
			"coordinates": "22.3811, 90.3372"
		},
		{
			"division": "Chattogram",
			"divisionbn": "চট্টগ্রাম",
			"coordinates": "23.1793, 91.9882"
		},
		{
			"...": "You get the idea. There are 8 divisions in total."
		}
	]
}
                    
Route:
https://bdapis.com/api/v1.2/division/rangpur
						
{
	"status": {
		"code": 200,
		"message": "ok",
		"date": "Wed, 12 May 2021 05:48:38 GMT"
	},
	"data": [
		{
			"district": "Dinajpur",
			"coordinates": "25.6279, 88.6332",
			"upazilla": [
				"Birampur",
				"Birganj",
				"Biral",
				"Bochaganj",
				"Chirirbandar",
				"Dinajpur Sadar",
				"Ghoraghat",
				"Hakimpur",
				"Kaharole",
				"Khansama",
				"Nawabganj",
				"Parbatipur",
				"Phulbari"
			]
		},
		{
			"district": "Gaibandha",
			"coordinates": "25.3297, 89.5430",
			"upazilla": [
				"Phulchhari",
				"Gaibandha Sadar",
				"Gobindaganj",
				"Palashbari",
				"Sadullapur",
				"Sughatta",
				"Sundarganj"
			]
		},
		{
			"...": "You get the idea. There are 64 districts in total."
		}
	]
}
                    

# Code Implementations

See the Pen BD API Example by Keramot UL Islam (@abmsourav) on CodePen.