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/convert

Try it in your browser

Parameters

ParameterTypeDescription
datestringThe 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>