Church Year

Returns where a date falls in the Western church year: the season (Advent, Christmas, Epiphany, Lent, Holy Week, Easter, or the season after Pentecost, also called Ordinary Time), the week of the season, the day's observance and liturgical color, the church year and its lectionary year (A, B or C), and that year's Western Easter and Orthodox Pascha. Defaults to today in Mountain Time.

{
  "type": "object",
  "properties": {
    "date": {
      "description": "Date in YYYY-MM-DD form, years 1583 to 4099. Defaults to today in Mountain Time.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Returns the appointed Bible readings (first reading, psalm, second reading, gospel, with the alternatives) for a Sunday or major feast from the three-year Sunday lectionary of the 1979 Book of Common Prayer, which is public domain. Give a date (a weekday without its own lessons moves to the next Sunday) or an occasion such as "advent-1", "proper-23", "easter-day" or "christmas-day" with a year of A, B or C. With include_text, adds the passage text from the World English Bible or King James Version, both public domain. Citations only, never another translation.

{
  "type": "object",
  "properties": {
    "date": {
      "description": "Date in YYYY-MM-DD form. Defaults to the next Sunday, Mountain Time.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "occasion": {
      "description": "Lectionary occasion instead of a date, for example \"advent-1\", \"lent-3\", \"proper-12\", \"trinity\", \"all-saints\".",
      "type": "string",
      "enum": [
        "advent-1",
        "advent-2",
        "advent-3",
        "advent-4",
        "christmas-day",
        "christmas-1",
        "holy-name",
        "christmas-2",
        "epiphany",
        "epiphany-1",
        "epiphany-2",
        "epiphany-3",
        "epiphany-4",
        "epiphany-5",
        "epiphany-6",
        "epiphany-7",
        "epiphany-8",
        "epiphany-last",
        "ash-wednesday",
        "lent-1",
        "lent-2",
        "lent-3",
        "lent-4",
        "lent-5",
        "palm-sunday",
        "holy-monday",
        "holy-tuesday",
        "holy-wednesday",
        "maundy-thursday",
        "good-friday",
        "holy-saturday",
        "easter-day",
        "easter-monday",
        "easter-tuesday",
        "easter-wednesday",
        "easter-thursday",
        "easter-friday",
        "easter-saturday",
        "easter-2",
        "easter-3",
        "easter-4",
        "easter-5",
        "easter-6",
        "ascension",
        "easter-7",
        "pentecost",
        "trinity",
        "proper-1",
        "proper-2",
        "proper-3",
        "proper-4",
        "proper-5",
        "proper-6",
        "proper-7",
        "proper-8",
        "proper-9",
        "proper-10",
        "proper-11",
        "proper-12",
        "proper-13",
        "proper-14",
        "proper-15",
        "proper-16",
        "proper-17",
        "proper-18",
        "proper-19",
        "proper-20",
        "proper-21",
        "proper-22",
        "proper-23",
        "proper-24",
        "proper-25",
        "proper-26",
        "proper-27",
        "proper-28",
        "proper-29",
        "st-andrew",
        "st-thomas",
        "st-stephen",
        "st-john",
        "holy-innocents",
        "confession-of-st-peter",
        "conversion-of-st-paul",
        "presentation",
        "st-matthias",
        "st-joseph",
        "annunciation",
        "st-mark",
        "st-philip-and-st-james",
        "visitation",
        "st-barnabas",
        "nativity-of-st-john-the-baptist",
        "st-peter-and-st-paul",
        "independence-day",
        "st-mary-magdalene",
        "st-james",
        "transfiguration",
        "st-mary-the-virgin",
        "st-bartholomew",
        "holy-cross",
        "st-matthew",
        "st-michael-and-all-angels",
        "st-luke",
        "st-james-of-jerusalem",
        "st-simon-and-st-jude",
        "all-saints",
        "thanksgiving"
      ]
    },
    "year": {
      "description": "Lectionary year for an occasion. Defaults to the year now in use.",
      "type": "string",
      "enum": [
        "A",
        "B",
        "C"
      ]
    },
    "include_text": {
      "description": "Also return the text of the first set of readings. Default false.",
      "type": "boolean"
    },
    "translation": {
      "description": "Translation for the text: \"web\" (World English Bible, default) or \"kjv\".",
      "type": "string",
      "enum": [
        "web",
        "kjv"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Lists the dated feasts, fasts and holy days in a window: Ash Wednesday, Holy Week, Easter, Ascension, Pentecost, Trinity, Christ the King, Advent, Christmas, the Epiphany, the feasts of our Lord, apostles and evangelists, with each day's color. Applies the 1979 Book of Common Prayer rules that move a feast off a Sunday or out of Holy Week and Easter Week. Optionally includes Orthodox Pascha, Julian-calendar Christmas and Reformation Day.

{
  "type": "object",
  "properties": {
    "from": {
      "description": "First date of the window, YYYY-MM-DD. Defaults to today in Mountain Time.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "days": {
      "description": "Length of the window in days, 1 to 400. Default 60.",
      "type": "integer",
      "minimum": 1,
      "maximum": 400
    },
    "include_other_traditions": {
      "description": "Include Orthodox Pascha, Julian-calendar Christmas and Reformation Day. Default true.",
      "type": "boolean"
    },
    "include_saints_days": {
      "description": "Include apostles', evangelists' and other saints' days. Default true.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Lays out a run of Sundays from a start date: each Sunday's name, season, color, lectionary year and appointed readings from the 1979 Book of Common Prayer lectionary, the seasons the run crosses, feasts that fall on those Sundays, and every book read on three or more consecutive Sundays, with the longest such run named as a possible series spine. Rule-based, no generated text.

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First date of the series, YYYY-MM-DD. A weekday starts at the next Sunday."
    },
    "weeks": {
      "type": "integer",
      "minimum": 1,
      "maximum": 26,
      "description": "Number of Sundays, 1 to 26."
    },
    "focus": {
      "description": "Look for the series spine in one reading only: first, second, gospel or psalm.",
      "type": "string",
      "enum": [
        "first",
        "second",
        "gospel",
        "psalm"
      ]
    }
  },
  "required": [
    "start_date",
    "weeks"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}