Calendar Converter API - Hijri, Hebrew, Chinese

Convert dates between 13 calendars (Gregorian, Islamic Umm al-Qura and tabular, Hebrew, Persian, Chinese, Korean, Japanese, Buddhist, Indian, Coptic, Ethiopian, Minguo) and get the dates of Islamic, Jewish, Chinese and Persian holidays for any year 1900-2100.

Authentication & base URL

Subscribe through one of our marketplace listings; your marketplace API key and base URL are shown there. All endpoints return JSON over HTTPS, served from a global edge network (typically 20–150 ms).

Subscribe on RapidAPI

Endpoints

GET `/v1/calendar/convert`

Gregorian date in all calendars

Parameter	In	Description	Example
`date`	query	Gregorian date YYYY-MM-DD (default: today)	`2026-10-12`
`calendars`	query	Optional comma list of calendar ids	`hebrew,islamic-umalqura,persian`

GET `/v1/calendar/to-gregorian`

Any calendar date to Gregorian

Parameter	In	Description	Example
`calendar` *	query	Calendar id	`hebrew`
`year` *	query	Year in that calendar	`5787`
`month` *	query	Month number (Hebrew: name, e.g. Nisan)	`Nisan`
`day` *	query	Day of month	`15`

GET `/v1/calendar/events`

Religious and cultural holidays

Parameter	In	Description	Example
`year` *	query	Gregorian year 1900-2100	`2027`
`type`	query	all, islamic, jewish, chinese or persian	`all`

GET `/v1/calendar/list`

Supported calendars

Example

GET /v1/calendar/convert?date=2026-10-12&calendars=hebrew%2Cislamic-umalqura%2Cpersian

{
  "gregorianDate": "2026-10-12",
  "weekday": "Monday",
  "calendars": [
    {
      "calendar": "hebrew",
      "name": "Hebrew",
      "year": 5787,
      "month": "Heshvan",
      "monthName": "Heshvan",
      "day": 1,
      "era": "AM",
      "formatted": "1 Heshvan 5787 AM"
    },
    {
      "calendar": "islamic-umalqura",
      "name": "Islamic (Umm al-Qura)",
      "year": 1448,
      "month": 5,
      "monthName": "Jumada I",
      "day": 1,
      "era": "AH",
      "formatted": "Jumada I 1, 1448 AH"
    },
    {
      "calendar": "persian",
      "name": "Persian (Solar Hijri)",
      "year": 1405,
      "month": 7,
      "monthName": "Mehr",
      "day": 20,
      "era": "AP",
      "formatted": "Mehr 20, 1405 AP"
    }
  ]
}

Use cases

Scheduling and HR software for global teams, e-commerce and marketing calendars (Ramadan, Chinese New Year campaigns), travel apps, religious and community apps, date pickers with local calendars.

Why this API

Standard ICU calendar engine, and Chinese month starts are checked against precise astronomical new moons (many libraries get Chinese New Year 2027 and 2030 wrong by a day; this API returns the official dates).
Fair pricing: Free plan 500 requests/month, Pro 25,000 for $4.99, Ultra 150,000 for $14.99.

Support

Questions or a feature you need? Open a thread in the Discussions tab.

Pricing

Free plan with 500 calls per month, then Pro (25,000 calls for $4.99/month) and Ultra (150,000 calls for $14.99/month). See all plans.