LiturCal

Data & embed

Put today’s celebration on your parish website, or use the calendar data in your own project. Free, no key, no sign-up.

Today on your website

Paste this where you want the box to appear. It shows the celebration, rank, color and season for the visitor’s own date and links to the full page.

<iframe src="https://liturcal.org/embed/today/" title="LiturCal" width="100%" height="150" loading="lazy" frameborder="0"></iframe>

For the provinces that keep the Ascension on Thursday, add ?ascension=thursday to the address.

JSON

Static files, served with open CORS headers. Replace en with es for Spanish.

  • https://liturcal.org/api/v1/en/days/YYYY-MM-DD.json — one day
  • https://liturcal.org/api/v1/en/YYYY.json — a whole year (2026, 2027, 2028)
  • https://liturcal.org/api/v1/index.json — what is available, and when it was built
{
 "date": "2026-11-17",
 "weekday": "Tuesday",
 "longDate": "Tuesday, November 17, 2026",
 "id": "elizabeth_of_hungary_religious",
 "name": "Saint Elizabeth of Hungary, Religious",
 "rank": "memorial",
 "rankLabel": "Memorial",
 "colors": [
  "white"
 ],
 "colorNames": [
  "White"
 ],
 "season": "ordinary",
 "seasonLabel": "Ordinary Time",
 "seasonWeek": 33,
 "seasonWeekLabel": "33rd week of Ordinary Time",
 "sundayCycle": "A",
 "weekdayCycle": "II",
 "psalterWeek": "1",
 "holyDay": false,
 "holyDayLabel": "Holy day of obligation",
 "obligationLifted": false,
 "penance": null,
 "observance": false,
 "summary": "Hungarian princess who gave herself to the poor and the sick in the thirteenth century",
 "readings": [
  {
   "label": null,
   "references": [
    "Revelation 3:1-6, 14-22",
    "Luke 19:1-10"
   ],
   "note": null,
   "lectionary": "498"
  }
 ],
 "readingsUrl": "https://bible.usccb.org/bible/readings/111726.cfm",
 "optional": [],
 "url": "/2026/11/17/"
}

On the two days a year when the Thursday-Ascension provinces differ, the day carries an ascensionThursday object with the same fields. The readings are references only.

Calendar feeds

iCalendar files are listed on the Subscribe page.

Terms

The calendar data (dates, names, ranks, colors, reading references) may be used freely for any purpose; a link back is appreciated. The written explanations may be quoted with a link to the page. Please cache what you fetch rather than requesting it on every page view. The data is provided as is, with no guarantee of accuracy; the address /api/v1/ will keep its shape.