API

The readings are available as JSON for use in other websites, apps and scripts. No key is needed, and requests from other websites are allowed. Please cache responses where you can.

Readings for a day

GET /api/v1/readings/<calendar>/<language>/<YYYY-MM-DD>

https://matutinum.org/api/v1/readings/1954/en/2026-11-04

Returns the office title (Latin and translated), its rank, and each lesson in Latin and in the translation. Each lesson has parts (title, citation, source, then verses with their numbers for Scripture, or paragraphs), the responsory (respond, verse, and Gloria Patri where it is said), and te_deum when the Te Deum follows. Days are published about two months ahead.

Today

GET /api/v1/today?calendar=1954&lang=en&tz=America/Los_Angeles

https://matutinum.org/api/v1/today

Without tz, the date is taken from the caller's location.

Calendars and languages

https://matutinum.org/api/v1/calendars

Errors

Errors return a JSON object with an error message and an HTTP status of 400, 404 or 503.

Texts from Divinum Officium (divinumofficium.com), distributed under the MIT License.