APIVerve

Liturgical Calendar API

GET
DocumentationStart for free →

Keep worship calendars in sync with Catholic feast days and seasons.

Liturgical Calendar is a simple tool for getting the dates of the Liturgical Calendar. It returns the dates of the Liturgical Calendar for a given year.

Try it — live request, no key required

Request
GETapi.apiverve.com/v1/liturgicalcalendar
Verification
Format

No key required to try it. Get a key to use it in your app.

200 OK
{
  "status": "ok",
  "error": null,
  "data": {
    "2026-01-01": [
      {
        "id": "mary_mother_of_god",
        "precedence": "GENERAL_SOLEMNITY_3",
        "rank": "SOLEMNITY",
        "isHolyDayOfObligation": true,
        "isOptional": false,
        "colors": [
          "WHITE"
        ]
      }
    ],
    "2026-01-02": [
      {
        "id": "basil_the_great_and_gregory_nazianzen_bishops",
        "precedence": "GENERAL_MEMORIAL_10",
        "rank": "MEMORIAL",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "WHITE"
        ],
        "weekday": {
          "id": "christmas_time_january_2",
          "date": "2026-01-02",
          "dateDef": {
            "dateFn": "weekdayBeforeEpiphany",
            "dateArgs": [
              2
            ],
            "yearOffset": 0
          },
          "dateExceptions": [],
          "alternativeTransferDateDefs": [],
          "precedence": "WEEKDAY_13",
          "rank": "WEEKDAY",
          "allowSimilarRankItems": false,
          "isHolyDayOfObligation": false,
          "isOptional": false,
          "i18nDef": [
            "seasons:christmas_time.before_epiphany",
            {
              "day": 2
            }
          ],
          "seasons": [
            "CHRISTMAS_TIME"
          ],
          "periods": [
            "DAYS_BEFORE_EPIPHANY",
            "CHRISTMAS_TO_PRESENTATION_OF_THE_LORD"
          ],
          "colors": [
            "WHITE"
          ],
          "commonsDef": [],
          "martyrology": [],
          "titles": [],
          "calendar": {
            "weekOfSeason": 2,
            "dayOfSeason": 9,
            "dayOfWeek": 5,
            "nthDayOfWeekInMonth": 1,
            "startOfSeason": "2025-12-25",
            "endOfSeason": "2026-01-11",
            "startOfLiturgicalYear": "2025-11-30",
            "endOfLiturgicalYear": "2026-11-28",
            "seasons": [
              "CHRISTMAS_TIME"
            ]
          },
          "cycles": {
            "properCycle": "PROPER_OF_TIME",
            "sundayCycle": "YEAR_A",
            "weekdayCycle": "YEAR_2",
            "psalterWeek": "WEEK_1"
          },
          "fromCalendarId": "ProperOfTime",
          "fromExtendedCalendars": []
        }
      }
    ],
    "2026-01-03": [
      {
        "id": "christmas_time_january_3",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "WHITE"
        ]
      },
      {
        "id": "most_holy_name_of_jesus",
        "precedence": "OPTIONAL_MEMORIAL_12",
        "rank": "OPTIONAL_MEMORIAL",
        "isHolyDayOfObligation": false,
        "isOptional": true,
        "colors": [
          "WHITE"
        ],
        "weekday": {
          "id": "christmas_time_january_3",
          "precedence": "WEEKDAY_13",
          "rank": "WEEKDAY",
          "isHolyDayOfObligation": false,
          "isOptional": false,
          "colors": [
            "WHITE"
          ]
        }
      }
    ],
    "2026-01-04": [
      {
        "id": "second_sunday_after_christmas",
        "precedence": "UNPRIVILEGED_SUNDAY_6",
        "rank": "SUNDAY",
        "isHolyDayOfObligation": true,
        "isOptional": false,
        "colors": [
          "WHITE"
        ]
      }
    ],
    "2026-01-05": [
      {
        "id": "christmas_time_january_5",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "WHITE"
        ]
      }
    ],
    "2026-01-06": [
      {
        "id": "epiphany_of_the_lord",
        "precedence": "PROPER_OF_TIME_SOLEMNITY_2",
        "rank": "SOLEMNITY",
        "isHolyDayOfObligation": true,
        "isOptional": false,
        "colors": [
          "WHITE"
        ]
      }
    ],
    "2026-01-07": [
      {
        "id": "wednesday_after_epiphany",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "WHITE"
        ]
      },
      {
        "id": "raymond_of_penyafort_priest",
        "precedence": "OPTIONAL_MEMORIAL_12",
        "rank": "OPTIONAL_MEMORIAL",
        "isHolyDayOfObligation": false,
        "isOptional": true,
        "colors": [
          "WHITE"
        ],
        "weekday": {
          "id": "wednesday_after_epiphany",
          "precedence": "WEEKDAY_13",
          "rank": "WEEKDAY",
          "isHolyDayOfObligation": false,
          "isOptional": false,
          "colors": [
            "WHITE"
          ]
        }
      }
    ],
    "2026-01-08": [
      {
        "id": "thursday_after_epiphany",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "WHITE"
        ]
      }
    ],
    "2026-01-09": [
      {
        "id": "friday_after_epiphany",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "WHITE"
        ]
      }
    ],
    "2026-01-10": [
      {
        "id": "saturday_after_epiphany",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "WHITE"
        ]
      }
    ],
    "2026-01-11": [
      {
        "id": "baptism_of_the_lord",
        "precedence": "PROPER_OF_TIME_SOLEMNITY_2",
        "rank": "SOLEMNITY",
        "isHolyDayOfObligation": true,
        "isOptional": false,
        "colors": [
          "WHITE"
        ]
      }
    ],
    "2026-01-12": [
      {
        "id": "ordinary_time_1_monday",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "GREEN"
        ]
      }
    ],
    "2026-01-13": [
      {
        "id": "ordinary_time_1_tuesday",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "GREEN"
        ]
      },
      {
        "id": "hilary_of_poitiers_bishop",
        "precedence": "OPTIONAL_MEMORIAL_12",
        "rank": "OPTIONAL_MEMORIAL",
        "isHolyDayOfObligation": false,
        "isOptional": true,
        "colors": [
          "WHITE"
        ],
        "weekday": {
          "id": "ordinary_time_1_tuesday",
          "precedence": "WEEKDAY_13",
          "rank": "WEEKDAY",
          "isHolyDayOfObligation": false,
          "isOptional": false,
          "colors": [
            "GREEN"
          ]
        }
      }
    ],
    "2026-01-14": [
      {
        "id": "ordinary_time_1_wednesday",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "GREEN"
        ]
      }
    ],
    "2026-01-15": [
      {
        "id": "ordinary_time_1_thursday",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "GREEN"
        ]
      }
    ],
    "2026-01-16": [
      {
        "id": "ordinary_time_1_friday",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "GREEN"
        ]
      }
    ],
    "2026-01-17": [
      {
        "id": "anthony_of_egypt_abbot",
        "precedence": "GENERAL_MEMORIAL_10",
        "rank": "MEMORIAL",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "WHITE"
        ],
        "weekday": {
          "id": "ordinary_time_1_saturday",
          "date": "2026-01-17",
          "dateDef": {
            "dateFn": "dateOfOrdinaryTime",
            "dateArgs": [
              6,
              1
            ],
            "yearOffset": 0
          },
          "dateExceptions": [],
          "alternativeTransferDateDefs": [],
          "precedence": "WEEKDAY_13",
          "rank": "WEEKDAY",
          "allowSimilarRankItems": false,
          "isHolyDayOfObligation": false,
          "isOptional": false,
          "i18nDef": [
            "seasons:ordinary_time.weekday",
            {
              "week": 1,
              "dow": 6
            }
          ],
          "seasons": [
            "ORDINARY_TIME"
          ],
          "periods": [
            "EARLY_ORDINARY_TIME"
          ],
          "colors": [
            "GREEN"
          ],
          "commonsDef": [],
          "martyrology": [],
          "titles": [],
          "calendar": {
            "weekOfSeason": 1,
            "dayOfSeason": 6,
            "dayOfWeek": 6,
            "nthDayOfWeekInMonth": 3,
            "startOfSeason": "2026-01-12",
            "endOfSeason": "2026-11-28",
            "startOfLiturgicalYear": "2025-11-30",
            "endOfLiturgicalYear": "2026-11-28",
            "seasons": [
              "ORDINARY_TIME"
            ]
          },
          "cycles": {
            "properCycle": "PROPER_OF_TIME",
            "sundayCycle": "YEAR_A",
            "weekdayCycle": "YEAR_2",
            "psalterWeek": "WEEK_1"
          },
          "fromCalendarId": "ProperOfTime",
          "fromExtendedCalendars": []
        }
      }
    ],
    "2026-01-18": [
      {
        "id": "ordinary_time_2_sunday",
        "precedence": "UNPRIVILEGED_SUNDAY_6",
        "rank": "SUNDAY",
        "isHolyDayOfObligation": true,
        "isOptional": false,
        "colors": [
          "GREEN"
        ]
      }
    ],
    "2026-01-19": [
      {
        "id": "ordinary_time_2_monday",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "GREEN"
        ]
      }
    ],
    "2026-01-20": [
      {
        "id": "ordinary_time_2_tuesday",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "GREEN"
        ]
      },
      {
        "id": "fabian_i_pope",
        "precedence": "OPTIONAL_MEMORIAL_12",
        "rank": "OPTIONAL_MEMORIAL",
        "isHolyDayOfObligation": false,
        "isOptional": true,
        "colors": [
          "RED"
        ],
        "weekday": {
          "id": "ordinary_time_2_tuesday",
          "precedence": "WEEKDAY_13",
          "rank": "WEEKDAY",
          "isHolyDayOfObligation": false,
          "isOptional": false,
          "colors": [
            "GREEN"
          ]
        }
      },
      {
        "id": "sebastian_of_milan_martyr",
        "precedence": "OPTIONAL_MEMORIAL_12",
        "rank": "OPTIONAL_MEMORIAL",
        "isHolyDayOfObligation": false,
        "isOptional": true,
        "colors": [
          "RED"
        ],
        "weekday": {
          "id": "ordinary_time_2_tuesday",
          "precedence": "WEEKDAY_13",
          "rank": "WEEKDAY",
          "isHolyDayOfObligation": false,
          "isOptional": false,
          "colors": [
            "GREEN"
          ]
        }
      }
    ],
    "2026-01-21": [
      {
        "id": "agnes_of_rome_virgin",
        "precedence": "GENERAL_MEMORIAL_10",
        "rank": "MEMORIAL",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "RED"
        ],
        "weekday": {
          "id": "ordinary_time_2_wednesday",
          "date": "2026-01-21",
          "dateDef": {
            "dateFn": "dateOfOrdinaryTime",
            "dateArgs": [
              3,
              2
            ],
            "yearOffset": 0
          },
          "dateExceptions": [],
          "alternativeTransferDateDefs": [],
          "precedence": "WEEKDAY_13",
          "rank": "WEEKDAY",
          "allowSimilarRankItems": false,
          "isHolyDayOfObligation": false,
          "isOptional": false,
          "i18nDef": [
            "seasons:ordinary_time.weekday",
            {
              "week": 2,
              "dow": 3
            }
          ],
          "seasons": [
            "ORDINARY_TIME"
          ],
          "periods": [
            "EARLY_ORDINARY_TIME"
          ],
          "colors": [
            "GREEN"
          ],
          "commonsDef": [],
          "martyrology": [],
          "titles": [],
          "calendar": {
            "weekOfSeason": 2,
            "dayOfSeason": 10,
            "dayOfWeek": 3,
            "nthDayOfWeekInMonth": 3,
            "startOfSeason": "2026-01-12",
            "endOfSeason": "2026-11-28",
            "startOfLiturgicalYear": "2025-11-30",
            "endOfLiturgicalYear": "2026-11-28",
            "seasons": [
              "ORDINARY_TIME"
            ]
          },
          "cycles": {
            "properCycle": "PROPER_OF_TIME",
            "sundayCycle": "YEAR_A",
            "weekdayCycle": "YEAR_2",
            "psalterWeek": "WEEK_2"
          },
          "fromCalendarId": "ProperOfTime",
          "fromExtendedCalendars": []
        }
      }
    ],
    "2026-01-22": [
      {
        "id": "ordinary_time_2_thursday",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "GREEN"
        ]
      },
      {
        "id": "vincent_of_saragossa_deacon",
        "precedence": "OPTIONAL_MEMORIAL_12",
        "rank": "OPTIONAL_MEMORIAL",
        "isHolyDayOfObligation": false,
        "isOptional": true,
        "colors": [
          "RED"
        ],
        "weekday": {
          "id": "ordinary_time_2_thursday",
          "precedence": "WEEKDAY_13",
          "rank": "WEEKDAY",
          "isHolyDayOfObligation": false,
          "isOptional": false,
          "colors": [
            "GREEN"
          ]
        }
      }
    ],
    "2026-01-23": [
      {
        "id": "ordinary_time_2_friday",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "GREEN"
        ]
      }
    ],
    "2026-01-24": [
      {
        "id": "francis_de_sales_bishop",
        "precedence": "GENERAL_MEMORIAL_10",
        "rank": "MEMORIAL",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "WHITE"
        ],
        "weekday": {
          "id": "ordinary_time_2_saturday",
          "date": "2026-01-24",
          "dateDef": {
            "dateFn": "dateOfOrdinaryTime",
            "dateArgs": [
              6,
              2
            ],
            "yearOffset": 0
          },
          "dateExceptions": [],
          "alternativeTransferDateDefs": [],
          "precedence": "WEEKDAY_13",
          "rank": "WEEKDAY",
          "allowSimilarRankItems": false,
          "isHolyDayOfObligation": false,
          "isOptional": false,
          "i18nDef": [
            "seasons:ordinary_time.weekday",
            {
              "week": 2,
              "dow": 6
            }
          ],
          "seasons": [
            "ORDINARY_TIME"
          ],
          "periods": [
            "EARLY_ORDINARY_TIME"
          ],
          "colors": [
            "GREEN"
          ],
          "commonsDef": [],
          "martyrology": [],
          "titles": [],
          "calendar": {
            "weekOfSeason": 2,
            "dayOfSeason": 13,
            "dayOfWeek": 6,
            "nthDayOfWeekInMonth": 4,
            "startOfSeason": "2026-01-12",
            "endOfSeason": "2026-11-28",
            "startOfLiturgicalYear": "2025-11-30",
            "endOfLiturgicalYear": "2026-11-28",
            "seasons": [
              "ORDINARY_TIME"
            ]
          },
          "cycles": {
            "properCycle": "PROPER_OF_TIME",
            "sundayCycle": "YEAR_A",
            "weekdayCycle": "YEAR_2",
            "psalterWeek": "WEEK_2"
          },
          "fromCalendarId": "ProperOfTime",
          "fromExtendedCalendars": []
        }
      }
    ],
    "2026-01-25": [
      {
        "id": "sunday_of_the_word_of_god",
        "precedence": "UNPRIVILEGED_SUNDAY_6",
        "rank": "SUNDAY",
        "isHolyDayOfObligation": true,
        "isOptional": false,
        "colors": [
          "GREEN"
        ]
      }
    ],
    "2026-01-26": [
      {
        "id": "timothy_of_ephesus_and_titus_of_crete_bishops",
        "precedence": "GENERAL_MEMORIAL_10",
        "rank": "MEMORIAL",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "WHITE"
        ],
        "weekday": {
          "id": "ordinary_time_3_monday",
          "date": "2026-01-26",
          "dateDef": {
            "dateFn": "dateOfOrdinaryTime",
            "dateArgs": [
              1,
              3
            ],
            "yearOffset": 0
          },
          "dateExceptions": [],
          "alternativeTransferDateDefs": [],
          "precedence": "WEEKDAY_13",
          "rank": "WEEKDAY",
          "allowSimilarRankItems": false,
          "isHolyDayOfObligation": false,
          "isOptional": false,
          "i18nDef": [
            "seasons:ordinary_time.weekday",
            {
              "week": 3,
              "dow": 1
            }
          ],
          "seasons": [
            "ORDINARY_TIME"
          ],
          "periods": [
            "EARLY_ORDINARY_TIME"
          ],
          "colors": [
            "GREEN"
          ],
          "commonsDef": [],
          "martyrology": [],
          "titles": [],
          "calendar": {
            "weekOfSeason": 3,
            "dayOfSeason": 15,
            "dayOfWeek": 1,
            "nthDayOfWeekInMonth": 4,
            "startOfSeason": "2026-01-12",
            "endOfSeason": "2026-11-28",
            "startOfLiturgicalYear": "2025-11-30",
            "endOfLiturgicalYear": "2026-11-28",
            "seasons": [
              "ORDINARY_TIME"
            ]
          },
          "cycles": {
            "properCycle": "PROPER_OF_TIME",
            "sundayCycle": "YEAR_A",
            "weekdayCycle": "YEAR_2",
            "psalterWeek": "WEEK_3"
          },
          "fromCalendarId": "ProperOfTime",
          "fromExtendedCalendars": []
        }
      }
    ],
    "2026-01-27": [
      {
        "id": "ordinary_time_3_tuesday",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "GREEN"
        ]
      },
      {
        "id": "angela_merici_virgin",
        "precedence": "OPTIONAL_MEMORIAL_12",
        "rank": "OPTIONAL_MEMORIAL",
        "isHolyDayOfObligation": false,
        "isOptional": true,
        "colors": [
          "WHITE"
        ],
        "weekday": {
          "id": "ordinary_time_3_tuesday",
          "precedence": "WEEKDAY_13",
          "rank": "WEEKDAY",
          "isHolyDayOfObligation": false,
          "isOptional": false,
          "colors": [
            "GREEN"
          ]
        }
      }
    ],
    "2026-01-28": [
      {
        "id": "thomas_aquinas_priest",
        "precedence": "GENERAL_MEMORIAL_10",
        "rank": "MEMORIAL",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "WHITE"
        ],
        "weekday": {
          "id": "ordinary_time_3_wednesday",
          "date": "2026-01-28",
          "dateDef": {
            "dateFn": "dateOfOrdinaryTime",
            "dateArgs": [
              3,
              3
            ],
            "yearOffset": 0
          },
          "dateExceptions": [],
          "alternativeTransferDateDefs": [],
          "precedence": "WEEKDAY_13",
          "rank": "WEEKDAY",
          "allowSimilarRankItems": false,
          "isHolyDayOfObligation": false,
          "isOptional": false,
          "i18nDef": [
            "seasons:ordinary_time.weekday",
            {
              "week": 3,
              "dow": 3
            }
          ],
          "seasons": [
            "ORDINARY_TIME"
          ],
          "periods": [
            "EARLY_ORDINARY_TIME"
          ],
          "colors": [
            "GREEN"
          ],
          "commonsDef": [],
          "martyrology": [],
          "titles": [],
          "calendar": {
            "weekOfSeason": 3,
            "dayOfSeason": 17,
            "dayOfWeek": 3,
            "nthDayOfWeekInMonth": 4,
            "startOfSeason": "2026-01-12",
            "endOfSeason": "2026-11-28",
            "startOfLiturgicalYear": "2025-11-30",
            "endOfLiturgicalYear": "2026-11-28",
            "seasons": [
              "ORDINARY_TIME"
            ]
          },
          "cycles": {
            "properCycle": "PROPER_OF_TIME",
            "sundayCycle": "YEAR_A",
            "weekdayCycle": "YEAR_2",
            "psalterWeek": "WEEK_3"
          },
          "fromCalendarId": "ProperOfTime",
          "fromExtendedCalendars": []
        }
      }
    ],
    "2026-01-29": [
      {
        "id": "ordinary_time_3_thursday",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "GREEN"
        ]
      }
    ],
    "2026-01-30": [
      {
        "id": "ordinary_time_3_friday",
        "precedence": "WEEKDAY_13",
        "rank": "WEEKDAY",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "GREEN"
        ]
      }
    ],
    "2026-01-31": [
      {
        "id": "john_bosco_priest",
        "precedence": "GENERAL_MEMORIAL_10",
        "rank": "MEMORIAL",
        "isHolyDayOfObligation": false,
        "isOptional": false,
        "colors": [
          "WHITE"
        ],
        "weekday": {
          "id": "ordinary_time_3_saturday",
          "date": "2026-01-31",
          "dateDef": {
            "dateFn": "dateOfOrdinaryTime",
            "dateArgs": [
              6,
              3
            ],
            "yearOffset": 0
          },
          "dateExceptions": [],
          "alternativeTransferDateDefs": [],
          "precedence": "WEEKDAY_13",
          "rank": "WEEKDAY",
          "allowSimilarRankItems": false,
          "isHolyDayOfObligation": false,
          "isOptional": false,
          "i18nDef": [
            "seasons:ordinary_time.weekday",
            {
              "week": 3,
              "dow": 6
            }
          ],
          "seasons": [
            "ORDINARY_TIME"
          ],
          "periods": [
            "EARLY_ORDINARY_TIME"
          ],
          "colors": [
            "GREEN"
          ],
          "commonsDef": [],
          "martyrology": [],
          "titles": [],
          "calendar": {
            "weekOfSeason": 3,
            "dayOfSeason": 20,
            "dayOfWeek": 6,
            "nthDayOfWeekInMonth": 5,
            "startOfSeason": "2026-01-12",
            "endOfSeason": "2026-11-28",
            "startOfLiturgicalYear": "2025-11-30",
            "endOfLiturgicalYear": "2026-11-28",
            "seasons": [
              "ORDINARY_TIME"
            ]
          },
          "cycles": {
            "properCycle": "PROPER_OF_TIME",
            "sundayCycle": "YEAR_A",
            "weekdayCycle": "YEAR_2",
            "psalterWeek": "WEEK_3"
          },
          "fromCalendarId": "ProperOfTime",
          "fromExtendedCalendars": []
        }
      }
    ]
  }
}

About the Liturgical Calendar API

Liturgical Calendar works by analyzing the data provided and returning the dates of the Liturgical Calendar for a given year. It uses various sources to determine the data and returns the dates.

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON
Default REST response
XML
Markup format
YAML
Human-readable
CSV
Tabular export
Beta
GraphQL
Query language
New
MCP
For AI agents
View all integrations →

Other ways to use Liturgical Calendar

Same data, same APIVerve account, same credit balance — one key works on all of them.

Give it to an AI agentConnect over MCP and your agent calls it as a native tool — Claude, Cursor, ChatGPT.on VerveKit Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.on VerveSheets Ground an agent on itA cited, machine-checkable fact your model can't produce on its own.on VerveContext

Questions.

Common questions about the Liturgical Calendar API.

Read the docs →
Which plan fits 25,000 liturgical calendar lookups a month?
Starter easily covers that volume. At 2 credits per request, 25,000 lookups consume 50,000 of Starter's 200,000 monthly credits, which works out to about $0.30 per 1,000 calls. The Free plan includes 100 lookups each month for testing.
Are lectionary cycles and season dates included on the Free plan?
No, lectionary cycles and season boundary dates require a paid plan. The Free plan provides basic event properties such as ranks, vestment colors, and holy day of obligation flags. Lectionary reading cycles, psalter weeks, liturgical precedence, and season start and end dates unlock on Starter and above.
Can I query dates for future or past years?
Yes, you can specify any year alongside a month parameter. Querying a custom year is a premium parameter requiring a paid plan, while the Free plan defaults to the current year. If month is omitted, requests return dates for the current month.
How does the API handle conflicting celebrations on the same date?
When multiple celebrations fall on the same day, the precedence field indicates which event is officially observed according to liturgical rank. For memorials that coincide with a weekday, the response includes a nested weekday object describing the underlying day, season, and any alternate transfer date definitions.
Can I use liturgical calendar data in a commercial church app?
Yes, commercial use is permitted on any paid plan. You can store and present feast days, liturgical colors, and seasonal dates within your own software or services. You may not resell or redistribute the raw data feed as a standalone calendar product.
More in this category

Calendar

View all 5 →
Browse by category
Finance 49Text Processing 45Data Conversion 33Data Generation 32Entertainment 24Games 21Domain Data 18Data Lookup 17Networking 14Geography 13Reference Data 11Data Validation 9Weather 8Math/Calculations 8Images 7AI/Computer Vision 6Astrology 6Data Processing 6Transportation 6Data Scraping 5Security 4Science 4Parsers 4Documents 3Food 3Lifestyle 3Health/Wellness 2News 1All 367 APIs →

Related articles

All articles →
Business Day Math Is Harder Than You ThinkWeekends, holidays, and country-specific rules make working day calculations surprisingly tricky. Here's what to watch for.Read Extract Clean Content from Any WebpageTurn messy web pages into clean Markdown. Perfect for content migration, archiving, AI training data, and building read-later tools.Read Take Your App Multilingual (No Rewrite)Add language support to an existing app without rearchitecting. Practical strategies for translation, detection, and localization.Read

Ready to build with Liturgical Calendar? Start with 200 free credits — one key unlocks all 300+ APIs.

Get a free API key→View pricing

Explore the catalog

300+ APIs on the same key and the same response shape.

Browse all APIs