§ 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
| Name | Type | Description |
|---|---|---|
| search | string | Substring match on name, short bio, and epithet. |
| countrySlug | string | Limit to saints linked to this country slug. |
| patronOf | string | Match patronage tags (e.g. travelers, students). |
| category | string | Match category tags (e.g. martyr, monk). |
| era | string | Substring match against era (e.g. 4th century). |
| gender | string | Exact match (male / female). |
| saintKind | string | Substring match (Hierarch, Empress, …). |
| cursor | string | Opaque cursor from a prior nextCursor. |
| limit | integer | Default 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_…"