Calendar

The single most popular endpoint: who is being commemorated today, in either calendar.

Today

GET /v1/calendar/today — defaults to Gregorian. Add ?calendar=julian for the Old Calendar.

curl https://livesofthesaintscalendar.com/api/v1/calendar/today \
  -H "Authorization: Bearer osc_live_…"
# Old Calendar:
curl "https://livesofthesaintscalendar.com/api/v1/calendar/today?calendar=julian" \
  -H "Authorization: Bearer osc_live_…"

{
  "date": "2026-05-22",
  "calendar": "gregorian",
  "month": 5,
  "day": 22,
  "saints": [
    {
      "slug": "saint-helena",
      "name": "Saint Helena",
      "shortBio": "…",
      "feastTitle": "Synaxis of Saints Constantine and Helena",
      "originCountry": { "slug": "greece", "name": "Greece", "isoCode": "GR" },
      "categories": ["empress"],
      "patronage": ["archaeologists"],
      "url": "/saints/saint-helena"
    }
  ]
}

Any date

GET /v1/calendar/{date} — date is YYYY-MM-DD. The calendar parameter controls whether the month/day is interpreted as Gregorian or Julian.

curl "https://livesofthesaintscalendar.com/api/v1/calendar/2026-12-25?calendar=julian" \
  -H "Authorization: Bearer osc_live_…"

Pascha & the movable feasts

GET /v1/calendar/pascha/{year} returns Orthodox Pascha and the full Triodion and Pentecostarion cycle — Great Lent, Holy Week, Ascension, Pentecost, All Saints — as civil (Gregorian) dates. The whole Church reckons these by the Julian Paschalion, so they fall on the same day for Old and New Calendar alike. The daily endpoints also surface any movable feast that lands on the requested day in a movableFeasts array.

curl https://livesofthesaintscalendar.com/api/v1/calendar/pascha/2026 \
  -H "Authorization: Bearer osc_live_…"

{
  "year": 2026,
  "pascha": "2026-04-12",
  "feasts": [
    { "key": "clean-monday", "title": "Clean Monday — Great Lent begins", "rank": "feast", "offset": -48, "date": "2026-02-23" },
    { "key": "palm-sunday", "title": "Palm Sunday — Entry of the Lord into Jerusalem", "rank": "great", "offset": -7, "date": "2026-04-05" },
    { "key": "pascha", "title": "Pascha — the Resurrection of the Lord", "rank": "great", "offset": 0, "date": "2026-04-12" },
    { "key": "ascension", "title": "Ascension of the Lord", "rank": "great", "offset": 39, "date": "2026-05-21" },
    { "key": "pentecost", "title": "Pentecost — Holy Trinity", "rank": "great", "offset": 49, "date": "2026-05-31" }
  ]
}

Great Feasts

GET /v1/calendar/great-feasts/{year} returns the Twelve Great Feasts and Pascha for a year by civil (Gregorian) date — nine fixed feasts plus the three movable ones (Palm Sunday, Ascension, Pentecost). Old-Calendar parishes keep the fixed feasts thirteen days later.

curl https://livesofthesaintscalendar.com/api/v1/calendar/great-feasts/2026 \
  -H "Authorization: Bearer osc_live_…"

Fasting

Every /calendar response carries a fasting object for the day — whether a fast is kept, which season (great-lent, nativity-fast, and the rest), and the traditional dietary tone (xerophagy, wine-oil, fish, no-meat, or fast-free). The fast and season are exact; the tone follows the traditional typikon and parish practice varies, so present it as guidance.

{
  "date": "2026-03-02",
  "calendar": "gregorian",
  "saints": [],
  "movableFeasts": [],
  "fasting": {
    "fast": true,
    "season": "great-lent",
    "tone": "xerophagy",
    "summary": "Great Lent — strict fast"
  }
}

Why two calendars?

The Eastern Orthodox world is split between the Revised Julian calendar — which keeps fixed feasts on the same dates as the civil Gregorian calendar — and the Old Julian calendar, currently 13 days behind. A fixed feast carries the same day-number on both: St Nicholas is December 6 either way, but Old-Calendar parishes keep that December 6 on what the civil calendar calls December 19. Pass ?calendar=julianand the endpoint maps today's civil date onto the Julian calendar before looking up the feast, so each tradition gets the saint it actually commemorates today. Saints with more than one commemoration expose every date in the feastDays array on the detail endpoint.