We are pleased to offer experimental support for a yahrzeit API.
Clients should POST x-www-form-urlencoded data to https://www.hebcal.com/yahrzeit
The following parameters must be specified
- cfg=json
- v=yahrzeit
The following parameters may be specified once
- years=3 – default 20
- hebdate=on – append Hebrew date to the event titles (default off)
- yizkor=on – Include Yizkor dates (Pesach 8th day, Shavuot 2nd day, Yom Kippur and Shmini Atzeret — default off)
Then, specify at least one input date based on the Gregorian date of death (or birth). The following parameters are required, substituting the X with increasing integers beginning with 1.
- yX=1983 – Gregorian year, 4-digit date
- mX=4 – Gregorian month, 1 or 2 digits (1=January, 12=December)
- dX=15 – Gregorian day of month (1-31)
- sX=on – Event occurred on Gregorian date after sunset (default off implies that event occurred before sunset)
- tX=Yahrzeit – type (either Yahrzeit, Birthday or Anniversary)
- nX=Plonit%20ben%20Ploni – name (optional)
Here is an example of two events, a Hebrew Birthday for Example1 and a Yahrzeit for Example2:
curl \ --compressed \ -H 'content-type: application/x-www-form-urlencoded' \ --data-raw 'cfg=json&v=yahrzeit&n1=Example1&t1=Birthday&d1=15&m1=4&y1=1983&s1=on&n2=Example2&t2=Yahrzeit&d2=13&m2=11&y2=2008&s2=off&hebdate=on&years=3' \ 'https://www.hebcal.com/yahrzeit'
The response will be text/json that looks like this:
{
"title": "Hebrew Anniversaries: Example1, Example2",
"date": "2021-05-12T17:52:44.991Z",
"items": [
{
"title": "Example2's 12th Yahrzeit (15th of Cheshvan)",
"date": "2020-11-02",
"memo": "Hebcal joins you in remembering Example2, whose 12th Yahrzeit occurs on Monday, November 2, corresponding to the 15th of Cheshvan, 5781.\n\nExample2's Yahrzeit begins at sundown on Sunday, November 1 and continues until sundown on the day of observance. It is customary to light a memorial candle at sundown as the Yahrzeit begins.\n\nMay your loved one's soul be bound up in the bond of eternal life and may their memory serve as a continued source of inspiration and comfort to you."
},
{
"title": "Example1's 38th Hebrew Birthday (3rd of Iyyar)",
"date": "2021-04-15",
"memo": "Hebcal joins you in honoring Example1, whose 38th Hebrew Birthday occurs on Thursday, April 15, corresponding to the 3rd of Iyyar, 5781.\n\nExample1's Hebrew Birthday begins at sundown on Wednesday, April 14 and continues until sundown on the day of observance."
},
{
"title": "Example2's 13th Yahrzeit (15th of Cheshvan)",
"date": "2021-10-21",
"memo": "Hebcal joins you in remembering Example2, whose 13th Yahrzeit occurs on Thursday, October 21, corresponding to the 15th of Cheshvan, 5782.\n\nExample2's Yahrzeit begins at sundown on Wednesday, October 20 and continues until sundown on the day of observance. It is customary to light a memorial candle at sundown as the Yahrzeit begins.\n\nMay your loved one's soul be bound up in the bond of eternal life and may their memory serve as a continued source of inspiration and comfort to you."
},
{
"title": "Example1's 39th Hebrew Birthday (3rd of Iyyar)",
"date": "2022-05-04",
"memo": "Hebcal joins you in honoring Example1, whose 39th Hebrew Birthday occurs on Wednesday, May 4, corresponding to the 3rd of Iyyar, 5782.\n\nExample1's Hebrew Birthday begins at sundown on Tuesday, May 3 and continues until sundown on the day of observance."
},
{
"title": "Example2's 14th Yahrzeit (15th of Cheshvan)",
"date": "2022-11-09",
"memo": "Hebcal joins you in remembering Example2, whose 14th Yahrzeit occurs on Wednesday, November 9, corresponding to the 15th of Cheshvan, 5783.\n\nExample2's Yahrzeit begins at sundown on Tuesday, November 8 and continues until sundown on the day of observance. It is customary to light a memorial candle at sundown as the Yahrzeit begins.\n\nMay your loved one's soul be bound up in the bond of eternal life and may their memory serve as a continued source of inspiration and comfort to you."
},
{
"title": "Example1's 40th Hebrew Birthday (3rd of Iyyar)",
"date": "2023-04-24",
"memo": "Hebcal joins you in honoring Example1, whose 40th Hebrew Birthday occurs on Monday, April 24, corresponding to the 3rd of Iyyar, 5783.\n\nExample1's Hebrew Birthday begins at sundown on Sunday, April 23 and continues until sundown on the day of observance."
},
{
"title": "Example2's 15th Yahrzeit (15th of Cheshvan)",
"date": "2023-10-30",
"memo": "Hebcal joins you in remembering Example2, whose 15th Yahrzeit occurs on Monday, October 30, corresponding to the 15th of Cheshvan, 5784.\n\nExample2's Yahrzeit begins at sundown on Sunday, October 29 and continues until sundown on the day of observance. It is customary to light a memorial candle at sundown as the Yahrzeit begins.\n\nMay your loved one's soul be bound up in the bond of eternal life and may their memory serve as a continued source of inspiration and comfort to you."
},
{
"title": "Example1's 41st Hebrew Birthday (3rd of Iyyar)",
"date": "2024-05-11",
"memo": "Hebcal joins you in honoring Example1, whose 41st Hebrew Birthday occurs on Saturday, May 11, corresponding to the 3rd of Iyyar, 5784.\n\nExample1's Hebrew Birthday begins at sundown on Friday, May 10 and continues until sundown on the day of observance."
}
]
}
