Liturgical Calendar API

OnlineCredit Usage:1 per callRefreshed 1 month ago

avg: 246ms|p50: 233ms|p75: 255ms|p90: 281ms|p99: 335ms

Overview

To use Liturgical Calendar, you need an API key. You can get one by creating a free account and visiting your dashboard.

View in Marketplace

GET Endpoint

URL

https://api.apiverve.com/v1/liturgicalcalendar

Example

How to call the Liturgical Calendar API in different programming languages.

cURL Request

curl -X GET \
  "https://api.apiverve.com/v1/liturgicalcalendar?month=2&year=2025" \
  -H "X-API-Key: your_api_key_here"

JavaScript (Fetch API)

const response = await fetch('https://api.apiverve.com/v1/liturgicalcalendar?month=2&year=2025', {
  method: 'GET',
  headers: {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

Python (Requests)

import requests

headers = {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.apiverve.com/v1/liturgicalcalendar?month=2&year=2025', headers=headers)

data = response.json()
print(data)

Go (net/http)

package main

import (
    "fmt"
    "io"
    "net/http"

)

func main() {
    req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/liturgicalcalendar?month=2&year=2025", nil)

    req.Header.Set("X-API-Key", "your_api_key_here")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Example Response

{
  "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": []
        }
      }
    ]
  }
}

Authentication

The Liturgical Calendar API requires authentication via API key. Include your API key in the request header:

Required Header

X-API-Key: your_api_key_here

Learn more about authentication →

Interactive API Playground

Test the Liturgical Calendar API directly in your browser with live requests and responses.

Try Liturgical Calendar APIView details and test in the API marketplace

Parameters

The following parameters are available for the Liturgical Calendar API:

Some Liturgical Calendar parameters marked with Premium are available exclusively on paid plans.View pricing

Get Liturgical Calendar Data

Parameter	Type	Required	Description	Default	Example
`month`	integer	`optional`	The month to get Liturgical Calendar data for (default: current month) Range: `1 - 12`	-	`2`
`year`Premium	integer	`optional`	The year to get Liturgical Calendar data for (default: current year) Range: `1900 - 2100`	-	`2025`

Response

The Liturgical Calendar API returns responses in JSON, XML, YAML, and CSV formats. The JSON response is shown in the Example section above; alternative formats below.

Other Response Formats

XML Response

200 OK

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</status>
  <error xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
  <data>
    <2026_01_01>
      <item>
        <id>mary_mother_of_god</id>
        <precedence>GENERAL_SOLEMNITY_3</precedence>
        <rank>SOLEMNITY</rank>
        <isHolyDayOfObligation>true</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
      </item>
    </2026_01_01>
    <2026_01_02>
      <item>
        <id>basil_the_great_and_gregory_nazianzen_bishops</id>
        <precedence>GENERAL_MEMORIAL_10</precedence>
        <rank>MEMORIAL</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
        <weekday>
          <id>christmas_time_january_2</id>
          <date>2026-01-02</date>
          <dateDef>
            <dateFn>weekdayBeforeEpiphany</dateFn>
            <dateArgs>
              <dateArg>2</dateArg>
            </dateArgs>
            <yearOffset>0</yearOffset>
          </dateDef>
          <dateExceptions>
          </dateExceptions>
          <alternativeTransferDateDefs>
          </alternativeTransferDateDefs>
          <precedence>WEEKDAY_13</precedence>
          <rank>WEEKDAY</rank>
          <allowSimilarRankItems>false</allowSimilarRankItems>
          <isHolyDayOfObligation>false</isHolyDayOfObligation>
          <isOptional>false</isOptional>
          <i18nDef>
            <item>seasons:christmas_time.before_epiphany</item>
            <item>
              <day>2</day>
            </item>
          </i18nDef>
          <seasons>
            <season>CHRISTMAS_TIME</season>
          </seasons>
          <periods>
            <period>DAYS_BEFORE_EPIPHANY</period>
            <period>CHRISTMAS_TO_PRESENTATION_OF_THE_LORD</period>
          </periods>
          <colors>
            <color>WHITE</color>
          </colors>
          <commonsDef>
          </commonsDef>
          <martyrology>
          </martyrology>
          <titles>
          </titles>
          <calendar>
            <weekOfSeason>2</weekOfSeason>
            <dayOfSeason>9</dayOfSeason>
            <dayOfWeek>5</dayOfWeek>
            <nthDayOfWeekInMonth>1</nthDayOfWeekInMonth>
            <startOfSeason>2025-12-25</startOfSeason>
            <endOfSeason>2026-01-11</endOfSeason>
            <startOfLiturgicalYear>2025-11-30</startOfLiturgicalYear>
            <endOfLiturgicalYear>2026-11-28</endOfLiturgicalYear>
            <seasons>
              <season>CHRISTMAS_TIME</season>
            </seasons>
          </calendar>
          <cycles>
            <properCycle>PROPER_OF_TIME</properCycle>
            <sundayCycle>YEAR_A</sundayCycle>
            <weekdayCycle>YEAR_2</weekdayCycle>
            <psalterWeek>WEEK_1</psalterWeek>
          </cycles>
          <fromCalendarId>ProperOfTime</fromCalendarId>
          <fromExtendedCalendars>
          </fromExtendedCalendars>
        </weekday>
      </item>
    </2026_01_02>
    <2026_01_03>
      <item>
        <id>christmas_time_january_3</id>
        <precedence>WEEKDAY_13</precedence>
        <rank>WEEKDAY</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
      </item>
      <item>
        <id>most_holy_name_of_jesus</id>
        <precedence>OPTIONAL_MEMORIAL_12</precedence>
        <rank>OPTIONAL_MEMORIAL</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>true</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
        <weekday>
          <id>christmas_time_january_3</id>
          <precedence>WEEKDAY_13</precedence>
          <rank>WEEKDAY</rank>
          <isHolyDayOfObligation>false</isHolyDayOfObligation>
          <isOptional>false</isOptional>
          <colors>
            <color>WHITE</color>
          </colors>
        </weekday>
      </item>
    </2026_01_03>
    <2026_01_04>
      <item>
        <id>second_sunday_after_christmas</id>
        <precedence>UNPRIVILEGED_SUNDAY_6</precedence>
        <rank>SUNDAY</rank>
        <isHolyDayOfObligation>true</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
      </item>
    </2026_01_04>
    <2026_01_05>
      <item>
        <id>christmas_time_january_5</id>
        <precedence>WEEKDAY_13</precedence>
        <rank>WEEKDAY</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
      </item>
    </2026_01_05>
    <2026_01_06>
      <item>
        <id>epiphany_of_the_lord</id>
        <precedence>PROPER_OF_TIME_SOLEMNITY_2</precedence>
        <rank>SOLEMNITY</rank>
        <isHolyDayOfObligation>true</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
      </item>
    </2026_01_06>
    <2026_01_07>
      <item>
        <id>wednesday_after_epiphany</id>
        <precedence>WEEKDAY_13</precedence>
        <rank>WEEKDAY</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
      </item>
      <item>
        <id>raymond_of_penyafort_priest</id>
        <precedence>OPTIONAL_MEMORIAL_12</precedence>
        <rank>OPTIONAL_MEMORIAL</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>true</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
        <weekday>
          <id>wednesday_after_epiphany</id>
          <precedence>WEEKDAY_13</precedence>
          <rank>WEEKDAY</rank>
          <isHolyDayOfObligation>false</isHolyDayOfObligation>
          <isOptional>false</isOptional>
          <colors>
            <color>WHITE</color>
          </colors>
        </weekday>
      </item>
    </2026_01_07>
    <2026_01_08>
      <item>
        <id>thursday_after_epiphany</id>
        <precedence>WEEKDAY_13</precedence>
        <rank>WEEKDAY</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
      </item>
    </2026_01_08>
    <2026_01_09>
      <item>
        <id>friday_after_epiphany</id>
        <precedence>WEEKDAY_13</precedence>
        <rank>WEEKDAY</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
      </item>
    </2026_01_09>
    <2026_01_10>
      <item>
        <id>saturday_after_epiphany</id>
        <precedence>WEEKDAY_13</precedence>
        <rank>WEEKDAY</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
      </item>
    </2026_01_10>
    <2026_01_11>
      <item>
        <id>baptism_of_the_lord</id>
        <precedence>PROPER_OF_TIME_SOLEMNITY_2</precedence>
        <rank>SOLEMNITY</rank>
        <isHolyDayOfObligation>true</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
      </item>
    </2026_01_11>
    <2026_01_12>
      <item>
        <id>ordinary_time_1_monday</id>
        <precedence>WEEKDAY_13</precedence>
        <rank>WEEKDAY</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>GREEN</color>
        </colors>
      </item>
    </2026_01_12>
    <2026_01_13>
      <item>
        <id>ordinary_time_1_tuesday</id>
        <precedence>WEEKDAY_13</precedence>
        <rank>WEEKDAY</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>GREEN</color>
        </colors>
      </item>
      <item>
        <id>hilary_of_poitiers_bishop</id>
        <precedence>OPTIONAL_MEMORIAL_12</precedence>
        <rank>OPTIONAL_MEMORIAL</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>true</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
        <weekday>
          <id>ordinary_time_1_tuesday</id>
          <precedence>WEEKDAY_13</precedence>
          <rank>WEEKDAY</rank>
          <isHolyDayOfObligation>false</isHolyDayOfObligation>
          <isOptional>false</isOptional>
          <colors>
            <color>GREEN</color>
          </colors>
        </weekday>
      </item>
    </2026_01_13>
    <2026_01_14>
      <item>
        <id>ordinary_time_1_wednesday</id>
        <precedence>WEEKDAY_13</precedence>
        <rank>WEEKDAY</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>GREEN</color>
        </colors>
      </item>
    </2026_01_14>
    <2026_01_15>
      <item>
        <id>ordinary_time_1_thursday</id>
        <precedence>WEEKDAY_13</precedence>
        <rank>WEEKDAY</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>GREEN</color>
        </colors>
      </item>
    </2026_01_15>
    <2026_01_16>
      <item>
        <id>ordinary_time_1_friday</id>
        <precedence>WEEKDAY_13</precedence>
        <rank>WEEKDAY</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>GREEN</color>
        </colors>
      </item>
    </2026_01_16>
    <2026_01_17>
      <item>
        <id>anthony_of_egypt_abbot</id>
        <precedence>GENERAL_MEMORIAL_10</precedence>
        <rank>MEMORIAL</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>WHITE</color>
        </colors>
        <weekday>
          <id>ordinary_time_1_saturday</id>
          <date>2026-01-17</date>
          <dateDef>
            <dateFn>dateOfOrdinaryTime</dateFn>
            <dateArgs>
              <dateArg>6</dateArg>
              <dateArg>1</dateArg>
            </dateArgs>
            <yearOffset>0</yearOffset>
          </dateDef>
          <dateExceptions>
          </dateExceptions>
          <alternativeTransferDateDefs>
          </alternativeTransferDateDefs>
          <precedence>WEEKDAY_13</precedence>
          <rank>WEEKDAY</rank>
          <allowSimilarRankItems>false</allowSimilarRankItems>
          <isHolyDayOfObligation>false</isHolyDayOfObligation>
          <isOptional>false</isOptional>
          <i18nDef>
            <item>seasons:ordinary_time.weekday</item>
            <item>
              <week>1</week>
              <dow>6</dow>
            </item>
          </i18nDef>
          <seasons>
            <season>ORDINARY_TIME</season>
          </seasons>
          <periods>
            <period>EARLY_ORDINARY_TIME</period>
          </periods>
          <colors>
            <color>GREEN</color>
          </colors>
          <commonsDef>
          </commonsDef>
          <martyrology>
          </martyrology>
          <titles>
          </titles>
          <calendar>
            <weekOfSeason>1</weekOfSeason>
            <dayOfSeason>6</dayOfSeason>
            <dayOfWeek>6</dayOfWeek>
            <nthDayOfWeekInMonth>3</nthDayOfWeekInMonth>
            <startOfSeason>2026-01-12</startOfSeason>
            <endOfSeason>2026-11-28</endOfSeason>
            <startOfLiturgicalYear>2025-11-30</startOfLiturgicalYear>
            <endOfLiturgicalYear>2026-11-28</endOfLiturgicalYear>
            <seasons>
              <season>ORDINARY_TIME</season>
            </seasons>
          </calendar>
          <cycles>
            <properCycle>PROPER_OF_TIME</properCycle>
            <sundayCycle>YEAR_A</sundayCycle>
            <weekdayCycle>YEAR_2</weekdayCycle>
            <psalterWeek>WEEK_1</psalterWeek>
          </cycles>
          <fromCalendarId>ProperOfTime</fromCalendarId>
          <fromExtendedCalendars>
          </fromExtendedCalendars>
        </weekday>
      </item>
    </2026_01_17>
    <2026_01_18>
      <item>
        <id>ordinary_time_2_sunday</id>
        <precedence>UNPRIVILEGED_SUNDAY_6</precedence>
        <rank>SUNDAY</rank>
        <isHolyDayOfObligation>true</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>GREEN</color>
        </colors>
      </item>
    </2026_01_18>
    <2026_01_19>
      <item>
        <id>ordinary_time_2_monday</id>
        <precedence>WEEKDAY_13</precedence>
        <rank>WEEKDAY</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>GREEN</color>
        </colors>
      </item>
    </2026_01_19>
    <2026_01_20>
      <item>
        <id>ordinary_time_2_tuesday</id>
        <precedence>WEEKDAY_13</precedence>
        <rank>WEEKDAY</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>GREEN</color>
        </colors>
      </item>
      <item>
        <id>fabian_i_pope</id>
        <precedence>OPTIONAL_MEMORIAL_12</precedence>
        <rank>OPTIONAL_MEMORIAL</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>true</isOptional>
        <colors>
          <color>RED</color>
        </colors>
        <weekday>
          <id>ordinary_time_2_tuesday</id>
          <precedence>WEEKDAY_13</precedence>
          <rank>WEEKDAY</rank>
          <isHolyDayOfObligation>false</isHolyDayOfObligation>
          <isOptional>false</isOptional>
          <colors>
            <color>GREEN</color>
          </colors>
        </weekday>
      </item>
      <item>
        <id>sebastian_of_milan_martyr</id>
        <precedence>OPTIONAL_MEMORIAL_12</precedence>
        <rank>OPTIONAL_MEMORIAL</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>true</isOptional>
        <colors>
          <color>RED</color>
        </colors>
        <weekday>
          <id>ordinary_time_2_tuesday</id>
          <precedence>WEEKDAY_13</precedence>
          <rank>WEEKDAY</rank>
          <isHolyDayOfObligation>false</isHolyDayOfObligation>
          <isOptional>false</isOptional>
          <colors>
            <color>GREEN</color>
          </colors>
        </weekday>
      </item>
    </2026_01_20>
    <2026_01_21>
      <item>
        <id>agnes_of_rome_virgin</id>
        <precedence>GENERAL_MEMORIAL_10</precedence>
        <rank>MEMORIAL</rank>
        <isHolyDayOfObligation>false</isHolyDayOfObligation>
        <isOptional>false</isOptional>
        <colors>
          <color>RED</color>
        </colors>
        <weekday>
          <id>ordinary_time_2_wednesday</id>
          <date>2026-01-21</date>
          <dateDef>
            <dateFn>dateOfOrdinaryTime</dateFn>
            <dateArgs>
              <dateArg>3</dateArg>
              <dateArg>2</dateArg>
            </dateArgs>
            <yearOffset>0</yearOffset>
          </dateDef>
          <dateExceptions>
          </dateExceptions>
          <alternativeTransferDateDefs>
          </alternativeTransferDateDefs>
          <precedence>WEEKDAY_13</precedence>

<!-- ... response truncated (974 total lines) -->

YAML Response

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

# ... response truncated (685 total lines)

CSV Response

200 OK

key	value
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:[]}}]

View in Marketplace

Response Structure

All API responses follow a consistent structure with the following fields:

Field	Type	Description	Example
`status`	string	Indicates whether the request was successful ("ok") or failed ("error")	`ok`
`error`	string \| null	Contains error message if status is "error", otherwise null	`null`
`data`	object \| null	Contains the API response data if successful, otherwise null	`{...}`

Learn more about response formats →

Response Data Fields

When the request is successful, the data object contains the following fields:

Response fields marked with Premium are available exclusively on paid plans.View pricing

Field	Type	Sample Value	Description
[ ] Array items:	array[1]	`Array of objects`	-
└ `id`	string	`"mary_mother_of_god"`	Unique identifier for the liturgical event
└ `precedence`Premium	string	`"GENERAL_SOLEMNITY_3"`	Liturgical rank precedence level for the event
└ `rank`	string	`"SOLEMNITY"`	Liturgical rank classification (e.g., WEEKDAY, FEAST)
└ `isHolyDayOfObligation`	boolean	`true`	Whether event is a holy day of obligation
└ `isOptional`	boolean	`false`	Whether the event is optional to observe
└ `colors`	array	`["WHITE"]`	Liturgical colors for the event (e.g., PURPLE, WHITE)
[ ] Array items:	array[1]	`Array of objects`	-
└ `id`	string	`"basil_the_great_and_gregory_nazianzen_bishops"`	Unique identifier for the liturgical event
└ `precedence`Premium	string	`"GENERAL_MEMORIAL_10"`	Liturgical rank precedence level for the event
└ `rank`	string	`"MEMORIAL"`	Liturgical rank classification (e.g., WEEKDAY, FEAST)
└ `isHolyDayOfObligation`	boolean	`false`	Whether event is a holy day of obligation
└ `isOptional`	boolean	`false`	Whether the event is optional to observe
└ `colors`	array	`["WHITE"]`	Liturgical colors for the event (e.g., PURPLE, WHITE)
└ `weekday`	object	`{...}`	-
└ `id`	string	`"christmas_time_january_2"`	Unique identifier for the liturgical event
└ `date`	string	`"2026-01-02"`	ISO date string for the liturgical event
└ `dateDef`	object	`{...}`	-
└ `dateFn`	string	`"weekdayBeforeEpiphany"`	-
└ `dateArgs`	array	`[2]`	-

Headers

Only X-API-Key is required. Optional headers include Accept for response format negotiation (JSON, XML, or YAML), User-Agent, and X-Request-ID for request tracing. See all request headers →

GraphQL AccessALPHA

Access Liturgical Calendar through GraphQL to combine it with other API calls in a single request. Query only the liturgical calendar data you need with precise field selection, and orchestrate complex data fetching workflows.

Test Liturgical Calendar in the GraphQL Explorer to confirm availability and experiment with queries.

Credit Cost: Each API called in your GraphQL query consumes its standard credit cost.

GraphQL Endpoint

POST https://api.apiverve.com/v1/graphql

GraphQL Query Example

query {
  liturgicalcalendar(
    input: {
      month: 2
      year: 2025
    }
  ) {
    2026_01_01
    2026_01_02
    2026_01_03
    2026_01_04
    2026_01_05
    2026_01_06
    2026_01_07
    2026_01_08
    2026_01_09
    2026_01_10
    2026_01_11
    2026_01_12
    2026_01_13
    2026_01_14
    2026_01_15
    2026_01_16
    2026_01_17
    2026_01_18
    2026_01_19
    2026_01_20
    2026_01_21
    2026_01_22
    2026_01_23
    2026_01_24
    2026_01_25
    2026_01_26
    2026_01_27
    2026_01_28
    2026_01_29
    2026_01_30
    2026_01_31
  }
}

Note: Authentication is handled via the x-api-key header in your GraphQL request, not as a query parameter.

Try in GraphQL Explorer GraphQL Documentation

CORS Support

The Liturgical Calendar API accepts cross-origin requests from any origin, so it can be called directly from browser-based applications without a proxy. See CORS support →

Rate Limiting

Liturgical Calendar requests are throttled per minute on the Free plan and unthrottled on paid plans. Exceeding the limit returns 429 Too Many Requests; rate-limit usage is reported in the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers. See per-plan limits and best practices →

Error Codes

The Liturgical Calendar API uses standard HTTP status codes — 200 on success, 400 for invalid parameters, 401 for missing or invalid keys, 403 for insufficient credits, 429 for rate-limit exhaustion, and 500/503 for server-side issues. Each error response includes an X-Request-ID header you can quote when contacting support. See full error handling guide →

SDKs for Liturgical Calendar

Official Liturgical Calendar packages on npm, PyPI, NuGet, and JitPack — plus a Postman collection and an OpenAPI spec. See the SDK guide →

JitPack

No-Code Integrations

Liturgical Calendar works with Zapier, Make, Pipedream, n8n, and Power Automate using the same API key. See setup guides →

Zapier

Make

Pipedream

n8n

Power Automate

Frequently Asked Questions

How do I get an API key for Liturgical Calendar?

Sign up for a free account at dashboard.apiverve.com. Your API key will be automatically generated and available in your dashboard. The same key works for Liturgical Calendar and all other APIVerve APIs. The free plan includes 1,000 credits plus a 500 credit bonus.

How many credits does Liturgical Calendar cost?

Each successful Liturgical Calendar API call consumes credits based on plan tier. Check the pricing section above for the exact credit cost. Failed requests and errors don't consume credits, so you only pay for successful liturgical calendar lookups.

Can I use Liturgical Calendar in production?

The free plan is for testing and development only. For production use of Liturgical Calendar, upgrade to a paid plan (Starter, Pro, or Mega) which includes commercial use rights, no attribution requirements, and guaranteed uptime SLAs. All paid plans are production-ready.

Can I use Liturgical Calendar from a browser?

Yes! The Liturgical Calendar API supports CORS with wildcard configuration, so you can call it directly from browser-based JavaScript without needing a proxy server. See the CORS section above for details.

What happens if I exceed my Liturgical Calendar credit limit?

When you reach your monthly credit limit, Liturgical Calendar API requests will return an error until you upgrade your plan or wait for the next billing cycle. You'll receive notifications at 80% and 95% usage to give you time to upgrade if needed.

Other ways to use Liturgical Calendar

Set up Liturgical Calendar on APIVerve, or reach the same source a different way. Your APIVerve account and credits work on all of them — one key, one balance.

Give it to an AI agentConnect over MCP and your agent calls it as a native tool — Claude, Cursor, ChatGPT.VerveKit →Reference →

Use it in Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.VerveSheets →Reference →

Ground an agent on itA cited, machine-checkable fact your model can't produce on its own.VerveContext →Reference →

What's Next?

Continue your journey with these recommended resources

Browse All APIs

Explore our complete catalog of APIs

Authentication Guide

Learn about API keys and security

Rate Limits

Understand usage limits and best practices

Was this page helpful?

Liturgical Calendar API

Overview

GET Endpoint

Example

Authentication

Interactive API Playground

Parameters

Get Liturgical Calendar Data

Response

Other Response Formats

Response Structure

Response Data Fields

Headers

GraphQL AccessALPHA

CORS Support

Rate Limiting

Error Codes

SDKs for Liturgical Calendar

No-Code Integrations

Frequently Asked Questions

People who used this also used...

Age Calculator

Date Calculator

Working Days

Other ways to use Liturgical Calendar

What's Next?

Browse All APIs

Authentication Guide

Rate Limits