Skip to main content

Hebrew Date Converter REST API

We offer a simple API for converting between Gregorian and Hebrew dates. Two output formats are supported: JSON and XML.

Gregorian to Hebrew – single

To convert from Gregorian to Hebrew date use this URL format:

https://www.hebcal.com/converter?cfg=json&gy=2011&gm=6&gd=2&g2h=1
  • gy=2011 – Gregorian year
  • gm=6 – Gregorian month (1=January, 12=December)
  • gd=2 – Gregorian day of month
  • g2h=1 – Convert from Gregorian to Hebrew date
  • gs=on – After sunset on Gregorian date
  • cfg=json – output format is JSON (cfg=json) or XML (cfg=xml)

Gregorian to Hebrew – range of dates

To convert a batch of Gregorian dates to Hebrew dates, use this URL format:

https://www.hebcal.com/converter?cfg=json&start=2021-12-29&end=2022-01-04&g2h=1
  • start=2021-12-29 – Gregorian start date in YYYY-MM-DD format
  • end=2022-01-04 – Gregorian end date in YYYY-MM-DD format
  • g2h=1 – Convert from Gregorian to Hebrew date
  • cfg=json – output format is JSON (cfg=json)

Hebrew to Gregorian – single date

To convert from Hebrew to Gregorian use this URL format:

https://www.hebcal.com/converter?cfg=json&hy=5749&hm=Kislev&hd=25&h2g=1
  • hy=5749 – Hebrew year
  • hm=Kislev – Hebrew month (Nisan, Iyyar, Sivan, Tamuz, Av, Elul, Tishrei, Cheshvan, Kislev, Tevet, Shvat, Adar, Adar1, Adar2)
  • hd=25 – Hebrew day of month
  • h2g=1 – Convert from Hebrew to Gregorian date
  • cfg=json – output format is JSON (cfg=json) or XML (cfg=xml)

In leap years, specifying Adar is the same as specifying Adar2. In non-leap years, all three of Adar, Adar1, and Adar2 are considered equivalent.

The API is somewhat lenient in what it accepts for Hebrew month names. You can specify sh%27vat or Sh%27vat or Shvat. It will always consistently generate Sh'vat in the response.

Similarly, the API accepts all of Adar1Adar 1Adar IAdar2Adar 2Adar II. Because the capital-i and the lowercase-L look the same in some fonts, we recommend using the numerals 1 and 2 in the API usage. In the generated responses, Hebcal always uses Adar I and Adar II for consistency and compatibility as we’ve done for over 20 years.

Note also an optional callback parameter:

  • callback=function – wraps the JSON output text in parentheses and a function name of your choosing. Callback function names may only use upper and lowercase alphabetic characters (A-Z, a-z), numbers (0-9), the period (.), the underscore (_).

Sample output in JSON and XML: