TorahCalc API

Welcome to the TorahCalc API. To be notified of any upcoming changes, you may subscribe to releases by watching the repository.

English Text Input Calculator

GET  /api/input

Use natural words to input what you want to calculate.

Query Parameters

Parameter Type Required Description
query String Yes The query to evaluate

Examples

/api/input?query=Convert 3 amos to inches.

Biblical and Talmudic Units

Unit Converter

GET  /api/unitconverter

Loading...

Query Parameters

Parameter Type Required Description

Examples

/api/unitconverter

Multi Unit Converter

GET  /api/unitcharts

Loading...

Query Parameters

Parameter Type Required Description

Examples

/api/unitcharts

Calendar and Zmanim

Birkas Hachama

GET  /api/hachama

Calculate the next Birkas Hachama date

Query Parameters

Parameter Type Required Description
year Number No The Gregorian year. The Birkas Hachama date returned will be the occurrence on or after this year. Defaults to current year.

Examples

/api/hachama

/api/hachama?year=2023

Daily Learning

GET  /api/dailylearning

Calculate the Daf Yomi, Nach Yomi, Yerushalmi Yomi, Daily Chofetz Chaim, Daily Rambam Chapter, Daily Shemirat HaLashon, Daily Psalms, and Weekly Daf for a given date

Query Parameters

Parameter Type Required Description
date String No The date to calculate the daily learning for in YYYY-MM-DD format (defaults to current date)

Examples

/api/dailylearning

/api/dailylearning?date=2023-12-11

Date Converter

GET  /api/dateconverter/gregtoheb

Convert a Gregorian date to a Hebrew date

Query Parameters

Parameter Type Required Description
year Number No The Gregorian year (defaults to current year)
month Number No The Gregorian month 1-12 (defaults to current month)
Allowed values
  • January
    1
  • February
    2
  • March
    3
  • April
    4
  • May
    5
  • June
    6
  • July
    7
  • August
    8
  • September
    9
  • October
    10
  • November
    11
  • December
    12
day Number No The Gregorian day 1-31 (defaults to current day)
afterSunset Boolean No Whether the date is after sunset (defaults to false)

Examples

/api/dateconverter/gregtoheb

/api/dateconverter/gregtoheb?year=2023&month=12&day=11&afterSunset=false

GET  /api/dateconverter/hebtogreg

Convert a Hebrew date to a Gregorian date

Query Parameters

Parameter Type Required Description
year Number No The Hebrew year (defaults to current year)
month Number No The Hebrew month 1-13 where 1=Nissan (defaults to current month)
Allowed values
  • Nissan
    1
  • Iyar
    2
  • Sivan
    3
  • Tammuz
    4
  • Av
    5
  • Elul
    6
  • Tishrei
    7
  • Cheshvan
    8
  • Kislev
    9
  • Tevet
    10
  • Shevat
    11
  • Adar
    12
  • Adar II
    13
day Number No The Hebrew day 1-30 (defaults to current day)
afterSunset Boolean No Whether the date is after sunset of the previous day (defaults to false)

Examples

/api/dateconverter/hebtogreg

/api/dateconverter/hebtogreg?year=5784&month=9&day=28&afterSunset=false

Holidays

GET  /api/holidays/gregorianyear

Calculate the holidays for a given Gregorian year.

Query Parameters

Parameter Type Required Description
gregorianYear Number No The Gregorian year to calculate holidays for (defaults to current year)
diaspora Boolean No Whether to calculate holidays for the diaspora holiday schedule. Set to false for Israel. (defaults to true)
major Boolean No Whether to include major holidays (defaults to true)
minor Boolean No Whether to include minor holidays (defaults to true)
fasts Boolean No Whether to include fast days (defaults to true)
roshChodesh Boolean No Whether to include Rosh Chodesh (defaults to true)
shabbosMevorchim Boolean No Whether to include Shabbos Mevorchim (defaults to false)
specialShabbos Boolean No Whether to include special Shabbos days (defaults to false)
modern Boolean No Whether to include modern / Israel national holidays (defaults to false)
chabad Boolean No Whether to include Chabad events (defaults to false)

Examples

/api/holidays/gregorianyear

/api/holidays/gregorianyear?gregorianYear=2023&diaspora=true&major=true&minor=true&fasts=true&roshChodesh=true&shabbosMevorchim=false&specialShabbos=false&modern=false&chabad=false

GET  /api/holidays/hebrewyear

Calculate the holidays for a given Hebrew calendar year.

Query Parameters

Parameter Type Required Description
hebrewYear Number No The Hebrew year to calculate holidays for (defaults to current year)
diaspora Boolean No Whether to calculate holidays for the diaspora holiday schedule. Set to false for Israel. (defaults to true)
major Boolean No Whether to include major holidays (defaults to true)
minor Boolean No Whether to include minor holidays (defaults to true)
fasts Boolean No Whether to include fast days (defaults to true)
roshChodesh Boolean No Whether to include Rosh Chodesh (defaults to true)
shabbosMevorchim Boolean No Whether to include Shabbos Mevorchim (defaults to false)
specialShabbos Boolean No Whether to include special Shabbos days (defaults to false)
modern Boolean No Whether to include modern / Israel national holidays (defaults to false)
chabad Boolean No Whether to include Chabad events (defaults to false)

Examples

/api/holidays/hebrewyear

/api/holidays/hebrewyear?hebrewYear=5784&diaspora=true&major=true&minor=true&fasts=true&roshChodesh=true&shabbosMevorchim=false&specialShabbos=false&modern=false&chabad=false

GET  /api/holidays/startdate

Calculate the holidays for a given year from a given start date in the Hebrew calendar.

Query Parameters

Parameter Type Required Description
hebrewYear Number No The Hebrew year to start calculating holidays from (defaults to current year)
hebrewMonth Number No The Hebrew month (1-13 where 1=Nissan) to start calculating holidays from (defaults to current month)
Allowed values
  • Nissan
    1
  • Iyar
    2
  • Sivan
    3
  • Tammuz
    4
  • Av
    5
  • Elul
    6
  • Tishrei
    7
  • Cheshvan
    8
  • Kislev
    9
  • Tevet
    10
  • Shevat
    11
  • Adar
    12
  • Adar II
    13
hebrewDay Number No The Hebrew day 1-30 to start calculating holidays from (defaults to current day)
diaspora Boolean No Whether to calculate holidays for the diaspora holiday schedule. Set to false for Israel. (defaults to true)
major Boolean No Whether to include major holidays (defaults to true)
minor Boolean No Whether to include minor holidays (defaults to true)
fasts Boolean No Whether to include fast days (defaults to true)
roshChodesh Boolean No Whether to include Rosh Chodesh (defaults to true)
shabbosMevorchim Boolean No Whether to include Shabbos Mevorchim (defaults to false)
specialShabbos Boolean No Whether to include special Shabbos days (defaults to false)
modern Boolean No Whether to include modern / Israel national holidays (defaults to false)
chabad Boolean No Whether to include Chabad events (defaults to false)

Examples

/api/holidays/startdate

/api/holidays/startdate?hebrewYear=5784&hebrewMonth=9&hebrewDay=28&diaspora=true&major=true&minor=true&fasts=true&roshChodesh=true&shabbosMevorchim=false&specialShabbos=false&modern=false&chabad=false

Leap Years

GET  /api/leapyears/hebrew

Check if a year is a leap year in the Hebrew calendar

Query Parameters

Parameter Type Required Description
year Number No The year to check (defaults to current year)

Examples

/api/leapyears/hebrew

/api/leapyears/hebrew?year=5784

GET  /api/leapyears/gregorian

Check if a year is a leap year in the Gregorian calendar

Query Parameters

Parameter Type Required Description
year Number No The year to check (defaults to current year)

Examples

/api/leapyears/gregorian

/api/leapyears/gregorian?year=2023

Molad

GET  /api/molad

Calculate the molad for a given Hebrew month

Query Parameters

Parameter Type Required Description
year Number No The Hebrew year (defaults to current year)
month Number No The Hebrew month 1-13 where 1=Nissan (defaults to current month)
Allowed values
  • Nissan
    1
  • Iyar
    2
  • Sivan
    3
  • Tammuz
    4
  • Av
    5
  • Elul
    6
  • Tishrei
    7
  • Cheshvan
    8
  • Kislev
    9
  • Tevet
    10
  • Shevat
    11
  • Adar
    12
  • Adar II
    13

Examples

/api/molad

/api/molad?year=5784&month=9

Sefiras HaOmer

GET  /api/omer/gregorian

Calculate the Sefiras HaOmer count for a given Gregorian date

Query Parameters

Parameter Type Required Description
date String No The date to calculate the Sefiras HaOmer count for in YYYY-MM-DD format (defaults to current date)

Examples

/api/omer/gregorian

/api/omer/gregorian?date=2023-04-07

GET  /api/omer/hebrew

Calculate the Sefiras HaOmer count for a given Hebrew date

Query Parameters

Parameter Type Required Description
year Number No The Hebrew year (defaults to current year)
month Number No The Hebrew month - 1 for Nissan, 2 for Iyar, 3 for Sivan (defaults to current month)
Allowed values
  • Nissan
    1
  • Iyar
    2
  • Sivan
    3
day Number No The Hebrew day 1-30 (defaults to current day)

Examples

/api/omer/hebrew

/api/omer/hebrew?year=5784&month=1&day=16

GET  /api/omer/year

Calculate the Sefiras HaOmer count for a given Gregorian year

Query Parameters

Parameter Type Required Description
year Number No The Gregorian year (defaults to current year)

Examples

/api/omer/year

/api/omer/year?year=2023

Shmita Years

GET  /api/shmita/check

Check if a given year is a Shmita year

Query Parameters

Parameter Type Required Description
year Number No The Hebrew year to check. Defaults to current year.

Examples

/api/shmita/check

/api/shmita/check?year=5784

GET  /api/shmita/next

Calculate the next Shmita year from a given year

Query Parameters

Parameter Type Required Description
year Number No The Hebrew year. The Shmita year returned will be the occurrence on or after this year. Defaults to current year.

Examples

/api/shmita/next

/api/shmita/next?year=5784

GET  /api/shmita/previous

Calculate the previous Shmita year from a given year

Query Parameters

Parameter Type Required Description
year Number No The Hebrew year. The Shmita year returned will be the occurrence on or before this year. Defaults to current year.

Examples

/api/shmita/previous

/api/shmita/previous?year=5784

Zmanim

GET  /api/zmanim

Calculate zmanim (halachic times) for a given date and location

Query Parameters

Parameter Type Required Description
date String No The date to calculate zmanim for in YYYY-MM-DD format (defaults to current date)
latitude Number Yes The latitude of the location to calculate zmanim for
longitude Number Yes The longitude of the location to calculate zmanim for
timezone Number No The timezone name of the location to calculate zmanim for (defaults to the timezone of the location)

Examples

/api/zmanim?latitude=40.7127753&longitude=-74.0059728

/api/zmanim?date=2023-12-11&latitude=40.7127753&longitude=-74.0059728&timezone=America/New_York

Zodiac

GET  /api/zodiac

Calculate the Hebrew zodiac sign for a given date

Query Parameters

Parameter Type Required Description
date String No The date to calculate the zodiac sign for in YYYY-MM-DD format (defaults to current date)

Examples

/api/zodiac

/api/zodiac?date=2023-12-11

Gematria

Gematria Calculator

GET  /api/gematria

Calculate the gematria of a word or phrase according to 25+ different methods

Query Parameters

Parameter Type Required Description
text String Yes The Hebrew word or phrase to calculate the gematria of
alef Number No The gematria of the spelling of Alef for Milui and Ne'elam calculations. Defaults to 111, the value of "אלף".
beis Number No The gematria of the spelling of Beis for Milui and Ne'elam calculations. Use 412 for "בית" or 402 for "בת". Defaults to 412, the value of "בית".
gimmel Number No The gematria of the spelling of Gimmel for Milui and Ne'elam calculations. Use 83 for "גימל" or 73 for "גמל". Defaults to 83, the value of "גימל".
dalet Number No The gematria of the spelling of Dalet for Milui and Ne'elam calculations. Use 434 for "דלת" or 444 for "דלית". Defaults to 434, the value of "דלת".
hey Number No The gematria of the spelling of Hey for Milui and Ne'elam calculations. Use 6 for "הא" or 15 for "הי" or 10 for "הה". Defaults to 6, the value of "הא".
vav Number No The gematria of the spelling of Vav for Milui and Ne'elam calculations. Use 12 for "וו" or 22 for "ויו" or 13 for "ואו". Defaults to 12, the value of "וו".
zayin Number No The gematria of the spelling of Zayin for Milui and Ne'elam calculations. Defaults to 67, the value of "זין".
ches Number No The gematria of the spelling of Ches for Milui and Ne'elam calculations. Use 418 for "חית" or 408 for "חת". Defaults to 418, the value of "חית".
tes Number No The gematria of the spelling of Tes for Milui and Ne'elam calculations. Use 419 for "טית" or 409 for "טת". Defaults to 419, the value of "טית".
yud Number No The gematria of the spelling of Yud for Milui and Ne'elam calculations. Defaults to 20, the value of "יוד".
kaf Number No The gematria of the spelling of Kaf for Milui and Ne'elam calculations. Defaults to 100, the value of "כף".
lamed Number No The gematria of the spelling of Lamed for Milui and Ne'elam calculations. Defaults to 74, the value of "למד".
mem Number No The gematria of the spelling of Mem for Milui and Ne'elam calculations. Defaults to 80, the value of "מם".
nun Number No The gematria of the spelling of Nun for Milui and Ne'elam calculations. Defaults to 106, the value of "נון".
samech Number No The gematria of the spelling of Samech for Milui and Ne'elam calculations. Defaults to 120, the value of "סמך".
ayin Number No The gematria of the spelling of Ayin for Milui and Ne'elam calculations. Defaults to 130, the value of "עין".
pey Number No The gematria of the spelling of Pey for Milui and Ne'elam calculations. Use 81 for "פא" or 90 for "פי" or 85 for "פה". Defaults to 81, the value of "פא".
tzadi Number No The gematria of the spelling of Tzadi for Milui and Ne'elam calculations. Use 104 for "צדי" or 204 for "צדיק". Defaults to 104, the value of "צדי".
kuf Number No The gematria of the spelling of Kuf for Milui and Ne'elam calculations. Defaults to 186, the value of "קוף".
resh Number No The gematria of the spelling of Resh for Milui and Ne'elam calculations. Use 510 for "ריש" or 500 for "רש". Defaults to 510, the value of "ריש".
shin Number No The gematria of the spelling of Shin for Milui and Ne'elam calculations. Use 350 for "שן" or 360 for "שין". Defaults to 350, the value of "שן".
tav Number No The gematria of the spelling of Tav for Milui and Ne'elam calculations. Use 406 for "תו" or 416 for "תיו" or 407 for "תאו". Defaults to 406, the value of "תו".

Examples

/api/gematria?text=תורה

/api/gematria?text=תורה&alef=111&beis=412&gimmel=83&dalet=434&hey=6&vav=12&zayin=67&ches=418&tes=419&yud=20&kaf=100&lamed=74&mem=80&nun=106&samech=120&ayin=130&pey=81&tzadi=104&kuf=186&resh=510&shin=350&tav=406

Gematria Lookup

GET  /api/gematriasearch

Search for words or verses with the same gematria as a given word or phrase

Query Parameters

Parameter Type Required Description
text String No The Hebrew word or phrase to find matching words or verses for
value Number No The gematria value to search for

Examples

/api/gematriasearch?text=תורה

/api/gematriasearch?value=611

Gematria Match Finder

GET  /api/gematriamatch

Find pairs of gematria methods where the given words have the same gematria value. For example, 53 = Mispar Siduri of "תורה" = AtBach of "עבודה"

Query Parameters

Parameter Type Required Description
word1 String Yes The first word to compare
word2 String Yes The second word to compare

Examples

/api/gematriamatch?word1=תורה&word2=משנה