Tempus — The Rhythm of the Year

The Calendar,
Computed.

Ask for any date and the engine answers with the season, the week within it, the rank of the celebration, the liturgical colour, the psalter week and the saint if the day belongs to one. The movable feasts are computed rather than tabulated, so the answer is as good for 2031 as for this morning — and the precedence rules decide which celebration wins when two fall together, which is the part that is genuinely hard to do by hand.

The request

GET /v1/ordo?date=2026-12-25
curl "https://api.torchandlily.com/v1/ordo?date=2026-12-25" \
  -H "X-API-Key: tl_your_key_here"

Every read endpoint takes the same header. Keys are free.

The response

200  application/json
{
  "date": "2026-12-25",
  "season": "CHRISTMASTIDE",
  "week": null,
  "psalter_week": null,
  "color": "WHITE",
  "color_hex": "#C8B88A",
  "rank": "SOLEMNITY",
  "title": "The Nativity of the Lord (Christmas)",
  "is_saint_feast": false,
  "saint_id": null,
  "saint_slug": null,
  "saint_name": null,
  "commemorations": []
}

The same response, set as a reader reads it

2026-12-25

The Nativity of the Lord (Christmas)

Season
Christmastide
Rank
Solemnity
Colour
White
Hex
#C8B88A

/v1/ordo/today for the current day · /v1/ordo/movable/2027 for a year's movable feasts

Build on it

The archive is public domain and the API is free to read. Sign in with Google or GitHub, mint a key, and make the call above yourself.

Responses captured 4 September 2026 · All examples