Calendars
Returns the daily or weekly learning schedule for a given date.
Query parameters
When this value is set to diaspora=1, the text returned is the weekly Torah reading for the diaspora. When this value is set to diaspora=0, the text returned is the Torah reading for Israel.
If available, the weekly Haftarah will be returned for one of the selected customs.
By default, the API returns learning for the current date. You can override it by using a combination of the year, day, and month params - all three of which must be used, or else the API will fall back to the default.
By default, the API returns learning for the current date. You can override it by using a combination of the year, day, and month params - all three of which must be used, or else the API will fall back to the default.
By default, the API returns learning for the current date. You can override it by using a combination of the year, day, and month params - all three of which must be used, or else the API will fall back to the default.
By default, the API attempts to return the calendar for the client's timezone. If you want the timezone for another region, you can override it. Timezone names are in accordance with IANA Standards
Response
Successful Response
Example response
{
"date": "2023-11-28",
"timezone": "America/Halifax",
"calendar_items": [
{
"title": {
"en": "Parashat Hashavua",
"he": "פרשת השבוע"
},
"displayValue": {
"en": "Vayishlach",
"he": "וישלח"
},
"url": "Genesis.32.4-36.43",
"ref": "Genesis 32:4-36:43",
"heRef": "בראשית ל״ב:ד׳-ל״ו:מ״ג",
"order": 1,
"category": "Tanakh",
"extraDetails": {
"aliyot": [
"Genesis 32:4-32:13",
"Genesis 32:14-32:30",
"Genesis 32:31-33:5",
"Genesis 33:6-33:20",
"Genesis 34:1-35:11",
"Genesis 35:12-36:19",
"Genesis 36:20-36:43",
"Genesis 36:40-36:43"
]
},
"description": {
"en": "Vayishlach (“He Sent”) follows Jacob and his family as Jacob wrestles with a man (commonly understood as an angel), is renamed Israel, and reconciles with his brother, Esau. Jacob’s daughter, Dina, is raped by a Hivite prince, and her brothers sack a city in response. Rachel dies as she gives birth to Jacob's youngest child, Benjamin.",
"he": "פרשת וישלח ממשיכה לעקוב אחרי יעקב ומשפחתו. יעקב נאבק עם איש (שלפי הפרשנות המקובלת הוא מלאך אלוהים), ובסיום המאבק האיש מעניק לו את השם ישראל. יעקב מתפייס עם אחיו עשו. דינה, בתו של יעקב, נאנסת ונשבית בידי נסיך חיווי, ואחיה הורגים את כל הזכרים בעיר ומשיבים אליהם את דינה. רחל מתה בשעת לידתו של בנימין, הצעיר בבני יעקב."
}
},
{
"title": {
"en": "Haftarah",
"he": "הפטרה"
},
"displayValue": {
"en": "Obadiah 1:1-21",
"he": "עובדיה א׳:א׳-כ״א"
},
"url": "Obadiah.1.1-21",
"ref": "Obadiah 1:1-21",
"order": 2,
"category": "Tanakh"
},
{
"title": {
"en": "Daf Yomi",
"he": "דף יומי"
},
"displayValue": {
"en": "Bava Kamma 26",
"he": "בבא קמא כ״ו"
},
"url": "Bava_Kamma.26",
"ref": "Bava Kamma 26",
"order": 3,
"category": "Talmud"
},
{
"title": {
"en": "929",
"he": "929"
},
"displayValue": {
"en": "Ezekiel 21 (473)",
"he": "יחזקאל כ״א (473)"
},
"url": "Ezekiel.21",
"ref": "Ezekiel 21",
"order": 4,
"category": "Tanakh"
},
{
"title": {
"en": "Daily Mishnah",
"he": "משנה יומית"
},
"displayValue": {
"en": "Mishnah Yevamot 10:4-5",
"he": "משנה יבמות י׳:ד׳-ה׳"
},
"url": "Mishnah_Yevamot.10.4-5",
"ref": "Mishnah Yevamot 10:4-5",
"order": 5,
"category": "Mishnah"
},
{
"title": {
"en": "Daily Rambam",
"he": "הרמב\"ם היומי"
},
"displayValue": {
"en": "Marriage 14",
"he": "הלכות אישות י״ד"
},
"url": "Mishneh_Torah,_Marriage.14",
"ref": "Mishneh Torah, Marriage 14",
"order": 6,
"category": "Halakhah"
},
{
"title": {
"en": "Daily Rambam (3 Chapters)",
"he": "הרמב\"ם היומי (3 פרקים)"
},
"displayValue": {
"en": "Other Sources of Defilement 9-11",
"he": "הלכות שאר אבות הטומאות ט׳-י״א"
},
"url": "Mishneh_Torah,_Other_Sources_of_Defilement.9-11",
"ref": "Mishneh Torah, Other Sources of Defilement 9-11",
"order": 7,
"category": "Halakhah"
},
{
"title": {
"en": "Daf a Week",
"he": "דף השבוע"
},
"displayValue": {
"en": "Ketubot 64",
"he": "כתובות ס״ד"
},
"url": "Ketubot.64",
"ref": "Ketubot 64",
"order": 8,
"category": "Talmud"
},
{
"title": {
"en": "Halakhah Yomit",
"he": "הלכה יומית"
},
"displayValue": {
"en": "Shulchan Arukh, Orach Chayim 535:2-536:1",
"he": "שולחן ערוך, אורח חיים תקל״ה:ב׳-תקל״ו:א׳"
},
"url": "Shulchan_Arukh,_Orach_Chayim.535.2-536.1",
"ref": "Shulchan Arukh, Orach Chayim 535:2-536:1",
"order": 9,
"category": "Halakhah"
},
{
"title": {
"en": "Arukh HaShulchan Yomi",
"he": "ערוך השולחן היומי"
},
"displayValue": {
"en": "Yoreh De'ah 191:7-15",
"he": "יורה דעה קצ״א:ז׳-ט״ו"
},
"url": "Arukh_HaShulchan,_Yoreh_De'ah.191.7-15",
"ref": "Arukh HaShulchan, Yoreh De'ah 191:7-15",
"order": 10,
"category": "Halakhah"
},
{
"title": {
"en": "Tanakh Yomi",
"he": "תנ\"ך יומי"
},
"displayValue": {
"en": "Samuel Seder 17",
"he": "שמואל סדר יז"
},
"url": "I_Samuel.25.33-26.24",
"ref": "I Samuel 25:33-26:24",
"order": 11,
"category": "Tanakh"
},
{
"title": {
"en": "Chok LeYisrael",
"he": "חק לישראל"
},
"displayValue": {
"en": "Vayishlach",
"he": "וישלח"
},
"url": "collections/חק-לישראל?tag=Vayishlach",
"order": 12,
"category": "Tanakh"
},
{
"title": {
"en": "Tanya Yomi",
"he": "תניא יומי"
},
"displayValue": {
"en": "15 Kislev",
"he": "טו כסלו"
},
"url": "Tanya,_Part_V;_Kuntres_Acharon.6.8",
"ref": "Tanya, Part V; Kuntres Acharon 6:8",
"order": 15,
"category": "Chasidut"
},
{
"title": {
"en": "Yerushalmi Yomi",
"he": "ירושלמי יומי"
},
"displayValue": {
"en": "Jerusalem Talmud Orlah 18",
"he": "תלמוד ירושלמי ערלה יח"
},
"url": "Jerusalem_Talmud_Orlah.3.1.16-3.1",
"ref": "Jerusalem Talmud Orlah 3:1:16-3:1",
"order": 16,
"category": "Talmud"
}
]
}