Lives of the Saints API

A public, read-only JSON API for Orthodox saints, hymnography, countries, and the liturgical calendar. Get a key in 30 seconds; make your first request in a minute.

1. Get an API key

Sign in (or create an account), then visit /user-account/developer to issue your first key. Plaintext is shown only once — store it somewhere safe.

2. Make a request

Every request takes a bearer token. Base URL is https://livesofthesaintscalendar.com/api/v1. Try a live request right here — paste your key and hit Send:

Equivalent curl:

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

3. What's in v1

• Saints — list, detail, hymnography, patron lookup.
• Countries — list and detail, including linked saints.
• Calendar — today's feast and any date, in Gregorian or Julian.
• Search — full-text across saints and countries.

4. Conventions

Responses are JSON. List endpoints return { "data": [...], "nextCursor": null | string } and accept a cursor + limit. Detail endpoints return the resource at the top level. Errors follow a uniform shape — see Errors.

CORS is open. Cache-friendly endpoints return Cache-Control: public, s-maxage=…. Rate-limit telemetry is in X-RateLimit-* response headers.

5. OpenAPI

A machine-readable OpenAPI 3.1 spec lives at /api/v1/openapi.json. Paste it into Postman, Insomnia, Scalar, or your favorite codegen.