Bangla Date API
A free public JSON API that converts any Gregorian date to the Bengali (Bangla Academy), Hijri (Islamic) and Hindu (Vikram Samvat) calendars in one call — including Bengali seasons, tithi, nakshatra and Bangladesh holidays. No API key, no signup, CORS enabled for browser use.
Endpoint
Send a GET request with an optional date parameter. Omit it to get today's date in Bangladesh (Asia/Dhaka).
Base URL
https://www.bangladatetoday.com/api/convertParameters
| Parameter | Type | Description |
|---|---|---|
date | string | The Gregorian date to convert, in YYYY-MM-DD format (e.g. 2026-04-14). Optional — defaults to today in Bangladesh. Supported years: 1900–2199. |
Example response
GET /api/convert?date=2026-04-14 — Pohela Boishakh, the first day of the Bengali year:
{
"date": "2026-04-14",
"weekday": { "en": "Tuesday", "bn": "মঙ্গলবার" },
"gregorian": {
"year": 2026, "month": 4, "day": 14,
"monthName": "April",
"formatted": {
"en": "Tuesday 14th April 2026",
"bn": "১৪ই এপ্রিল ২০২৬ খ্রিষ্টাব্দ"
}
},
"bengali": {
"year": 1433, "month": 1, "day": 1,
"monthName": { "en": "Boishakh", "bn": "বৈশাখ" },
"season": { "en": "Summer", "bn": "গ্রীষ্ম" },
"formatted": {
"en": "Tuesday 1st Boishakh 1433",
"bn": "মঙ্গলবার, ১লা বৈশাখ ১৪৩৩ বঙ্গাব্দ"
}
},
"hijri": {
"year": 1447, "month": 10, "day": 25,
"monthName": { "en": "Shawwal", "bn": "শাওয়াল" },
"formatted": {
"en": "25 Shawwal 1447 AH",
"bn": "২৫ শাওয়াল ১৪৪৭ হিজরি"
},
"note": "Tabular calculation adjusted for Bangladesh. Actual dates may vary by ±1 day depending on moon sighting."
},
"hindu": {
"vikramSamvat": 2083,
"shakaSamvat": 1948,
"masa": { "en": "Chaitra", "bn": "চৈত্র" },
"paksha": { "en": "Krishna", "bn": "কৃষ্ণ" },
"tithi": { "number": 25, "en": "Dashami", "bn": "দশমী" },
"nakshatra": { "en": "Dhanishta", "bn": "ধনিষ্ঠা" },
"ritu": { "en": "Vasant (Spring)", "bn": "বসন্ত" }
},
"holidays": [
{
"name": {
"en": "Bengali New Year (Pohela Boishakh)",
"bn": "বাংলা নববর্ষ (পহেলা বৈশাখ)"
},
"type": "General",
"religion": "All"
}
],
"meta": {
"timezone": "Asia/Dhaka",
"source": "https://www.bangladatetoday.com",
"docs": "https://www.bangladatetoday.com/bangla-date-api"
}
}Rate limits, caching & CORS
- 60 requests per minute per IP. When exceeded, the API returns HTTP 429 with a Retry-After header.
- Responses for explicit dates are cacheable for 24 hours (Cache-Control is set) — cache them on your side too.
- CORS is fully open (Access-Control-Allow-Origin: *), so you can call the API directly from browser JavaScript.
Accuracy notes
- Bengali dates follow the official Bangla Academy calendar (1987 reform, 2019 revision) used in Bangladesh.
- Hijri dates use a tabular calculation adjusted for Bangladesh (Islamic Foundation convention). Actual dates may vary by ±1 day depending on moon sighting.
- Hindu panchang data (tithi, nakshatra, masa) is astronomically calculated for the Indian standard meridian.
Attribution
The API is free for personal and commercial projects. If it powers something public — an app, a widget, a website — a visible link back to BanglaDateToday is appreciated. It keeps the service free for everyone.
Link to us with:
<a href="https://www.bangladatetoday.com">Bengali Calendar — BanglaDateToday</a>