download the app
§ Resources · Saints

Saints

List, fetch, search, and discover saints by patronage, country, era, or category.

Try itLive request from your browser

Paginated list. Try patronOf=travelers, countrySlug=greece, etc.

Parameters
GET https://livesofthesaintscalendar.com/api/v1/saints

List saints

GET /v1/saints — paginated list of published saints. Cursor-based pagination via nextCursor.

Query parameters

NameTypeDescription
searchstringSubstring match on name, short bio, and epithet.
countrySlugstringLimit to saints linked to this country slug.
patronOfstringMatch patronage tags (e.g. travelers, students).
categorystringMatch category tags (e.g. martyr, monk).
erastringSubstring match against era (e.g. 4th century).
genderstringExact match (male / female).
saintKindstringSubstring match (Hierarch, Empress, …).
cursorstringOpaque cursor from a prior nextCursor.
limitintegerDefault 25, max 100.

Example

bashbash
curl "https://livesofthesaintscalendar.com/api/v1/saints?patronOf=travelers&limit=5" \
  -H "Authorization: Bearer osc_live_…"
jsonjson
{
  "data": [
    {
      "slug": "saint-helena",
      "name": "Saint Helena",
      "shortBio": "Mother of Constantine the Great…",
      "saintKind": "Empress",
      "era": "4th century",
      "region": "Constantinople",
      "gender": "female",
      "feastDateIso": "2026-05-21",
      "originCountry": { "slug": "greece", "name": "Greece", "isoCode": "GR", "continent": "Europe" },
      "categories": ["empress", "finder-of-the-true-cross"],
      "patronage": ["archaeologists", "converts"],
      "iconUrl": "https://…/saint-helena.jpg",
      "url": "/saints/saint-helena"
    }
  ],
  "nextCursor": "saint-john-chrysostom"
}

Get a saint by slug

GET /v1/saints/{slug} — returns the full saint record, including all feast days, linked countries, related saints, and synaxarion fields.

bashbash
curl https://livesofthesaintscalendar.com/api/v1/saints/saint-helena \
  -H "Authorization: Bearer osc_live_…"
jsonjson
{
  "slug": "saint-helena",
  "name": "Saint Helena",
  "shortBio": "…",
  "altNames": ["Helena Augusta"],
  "epithet": "Equal-to-the-Apostles",
  "feastDays": [
    { "month": 5, "day": 21, "calendar": "gregorian", "title": "Synaxis of Saints Constantine and Helena" }
  ],
  "countries": [{ "slug": "greece", "name": "Greece", "isoCode": "GR", "continent": "Europe" }],
  "patronage": ["archaeologists", "converts"],
  "keyFacts": { … },
  "sources": [ … ]
}

Hymnography

GET /v1/saints/{slug}/hymnography— just the troparion, kontakion, prayer, and mode. Good for liturgical apps that don't want the whole record.

jsonjson
{
  "saint": { "slug": "saint-helena", "name": "Saint Helena" },
  "troparionHtml": "<p>Having beheld the image…</p>",
  "troparionMode": "Plagal of the Fourth",
  "troparionSource": "Menaion",
  "kontakionHtml": "<p>…</p>",
  "prayerHtml": "<p>…</p>"
}

Patron saints

Use the patronOf filter on the list endpoint. Tags are lowercase and free-form — common ones include travelers, students, mothers, physicians.

bashbash
curl "https://livesofthesaintscalendar.com/api/v1/saints?patronOf=mothers" \
  -H "Authorization: Bearer osc_live_…"