Public API

Saint of the Day API

Free JSON endpoints for the daily Catholic saint, sourced from mycatholic.life with fall-back to the Roman Martyrology via catholic.org. Bilingual (English + Tamil), free to use, no auth required.

✓ Free ✓ CORS enabled ✓ Cached 1h–24h ⚠ 60 req/min/IP

Base URL

https://spiritfilledproclamation.online/api

GET /api/saint alias: /api/saint/today

Returns today's saint (or feria liturgical-season info if no celebration is on the calendar).

Query parameters (optional)

lang=en or lang=ta	Return only that language's `name` and `description` as plain strings (rather than the default `{en, ta}` object). Cuts payload ~50%.
summary=true	Truncate `description` to the first ~320 characters at a sentence boundary. Useful for cards / notifications. Cuts payload ~95%.

Examples

# Full bilingual payload (~ 50 KB)
curl "https://spiritfilledproclamation.online/api/saint"

# English summary card (~ 1.5 KB)
curl "https://spiritfilledproclamation.online/api/saint?lang=en&summary=true"

GET /api/saint/<YYYY-MM-DD>

Returns the saint for a specific date. Accepts the same ?lang and ?summary params. Cached for 24 h by the browser.

Examples

# Christmas — Solemnity
curl "https://spiritfilledproclamation.online/api/saint/2026-12-25"

# Our Lady of Fatima — Tamil only
curl "https://spiritfilledproclamation.online/api/saint/2026-05-13?lang=ta"

Error responses

# Malformed date
HTTP/1.1 400 Bad Request
{ "error": "date must be YYYY-MM-DD" }

# Rate limit exceeded
HTTP/1.1 429 Too Many Requests

GET /api/saints/range/<start>/<end> also: /api/saints/week

Return saints across a date range (inclusive). Capped at 31 days. Honors the same ?lang and ?summary params. Perfect for building a week / month calendar widget with one request.

Examples

# This week (next 7 days), short cards
curl "https://spiritfilledproclamation.online/api/saints/week?summary=true"

# Whole May 2026, English-only
curl "https://spiritfilledproclamation.online/api/saints/range/2026-05-01/2026-05-31?lang=en&summary=true"

Response shape

{
  "start":  "2026-05-11",
  "end":    "2026-05-17",
  "count":  7,
  "saints": [ /* array of saint objects, same shape as /api/saint */ ]
}

Response shape

All fields are always present (empty string / null when not applicable).

{
  "date":               "2026-05-12",
  "has_saint":          true,
  "name": {
    "en": "Saints Nereus and Achilleus",
    "ta": ""
  },
  "type":               "MEMORIAL",   // SOLEMNITY | FEAST | MEMORIAL | OPT_MEMORIAL | FERIA
  "description": {
    "en": "Not long after Jesus' death...",
    "ta": "இயேசுவின் மரணத்திற்குப் பிறகு..."
  },
  "quote":              "Nereus and Achilleus the martyrs...",
  "image":              "https://spiritfilledproclamation.online/static/uploads/saints/abc.webp",
  "image_is_fallback":  false,             // true if no source image found
  "image_source":       "https://mycatholic.life/...",
  "source_url":         "https://mycatholic.life/...",
  "season":             "Eastertide",    // Liturgical season
  "next_saint":         null              // {date, name_en, name_ta, type, image, days_away} if today is feria
}

JavaScript example

async function loadSaint() {
  const r = await fetch("https://spiritfilledproclamation.online/api/saint?lang=en&summary=true");
  const s = await r.json();

  document.getElementById("saint-name").textContent = s.name;
  document.getElementById("saint-bio").textContent  = s.description;
  document.getElementById("saint-img").src          = s.image;
}

Attribution & licensing

Saint biographies and quotes are from mycatholic.life, used here under fair-use for ministry purposes. The source_url field on every response points back to the original page — please surface it in your UI as attribution.
Fallback biographies from Catholic Online Roman Martyrology pages.
Tamil translations are machine-generated (MyMemory) — verify before liturgical or print use.
Liturgical calendar metadata via the open-source catholic-readings-api.

Other endpoints

Endpoint	Returns
`GET /api/readings/today`	Today's Mass readings (1st, psalm, 2nd, Gospel) — Universalis JSON.
`GET /api/live-status`	Whether the priest's YouTube channel is currently live-streaming.
`GET /api/search?q=...`	Full-text search across prayers + sermons.