{
  "name": "Kirkkovuosi API",
  "version": "2.0.0",
  "description": "Church year calendar and lectionary for the Evangelical-Lutheran Church of Finland",
  "sources": [
    "Evankeliumikirja (Kirkkokäsikirja II, 2021)",
    "Jumalanpalvelusten kirja (Kirkkokäsikirja I, 2000)",
    "Viikkolektionaarin raamatunkohdat"
  ],
  "endpoints": [
    "GET /api/v1/today — Everything that varies with the church year for today (?cycles=false omits other year cycles)",
    "GET /api/v1/today/texts — Bible texts, psalm and hallelujah verse for today (?cycle=1|2|3)",
    "GET /api/v1/today/prayer — A prayer of the day (?n=2 for a specific one, ?all=true for all)",
    "GET /api/v1/today/gospel — Gospel reading for today",
    "GET /api/v1/today/propers — Liturgical propers and rubrics for today",
    "GET /api/v1/today/color — Liturgical colour for today",
    "GET /api/v1/today/liturgy — Seasonal rubrics (Gloria, Hallelujah, Gloria Patri) for today",
    "GET /api/v1/today/lectionary — Prayer-hour texts of the weekly lectionary for today",
    "GET /api/v1/date/:date — Everything for a specific date (YYYY-MM-DD)",
    "GET /api/v1/date/:date/texts — Texts for a date (?cycle=1|2|3)",
    "GET /api/v1/date/:date/prayer — A prayer for a date",
    "GET /api/v1/date/:date/gospel — Gospel for a date",
    "GET /api/v1/date/:date/propers — Propers for a date",
    "GET /api/v1/date/:date/color — Liturgical colour for a date",
    "GET /api/v1/date/:date/liturgy — Seasonal rubrics for a date",
    "GET /api/v1/date/:date/lectionary — Prayer-hour texts of the weekly lectionary (morning, midday, evening = first or second vespers, day psalm, apocrypha)",
    "All /today/* and /date/:date/* views: ?day=<slug> picks one of several days on the date (e.g. ?day=paasiaisyo); alsoOnThisDate lists the others",
    "GET /api/v1/holy-day/:slug — Full data for a holy day (?cycle=1|2|3, ?year=YYYY, ?raw=true)",
    "GET /api/v1/year/:year/calendar — Church year calendar starting at Advent of :year",
    "GET /api/v1/days — List all holy days",
    "GET /api/v1/periods — Introductions of the periods of the church year",
    "GET /api/v1/search/text?q=Matt.+21 — Search readings by Bible reference",
    "GET /api/v1/propers/prefaatiot — All preface endings by season",
    "GET /api/v1/propers/kyrie-litaniat — Seasonal Kyrie litanies",
    "GET /api/v1/propers/synninpaastot — Absolution texts",
    "GET /api/v1/propers/kiitosrukoukset — Thanksgiving prayers after absolution",
    "GET /api/v1/propers/kiitosrukoukset-ehtoollinen — Seasonal thanksgiving prayers after communion",
    "GET /api/v1/propers/kertosaakeet — Seasonal psalm refrains",
    "GET /api/v1/propers/improperia — Good Friday Improperia",
    "GET /api/v1/lectionary — Lectionary index metadata",
    "GET /api/v1/lectionary/holy-days — All holy day names in the lectionary",
    "GET /api/v1/lectionary/by-holy-day?q=pääsiäisyö — Readings for a holy day",
    "GET /api/v1/lectionary/search?q=Matt.+5 — Search lectionary by Bible reference"
  ]
}