Saints Day Endpoint

Get saints and fixed feasts for a specific day.

Request

GET /saints/day/{date}

Parameters:

Parameter	Type	In	Description
`date`	string	path	Date in `YYYY-MM-DD` format.
`lang`	string	query	`ru` (default) or `en`.
`type`	integer	query	Filter by legacy classification ID (`type`).

Constraints: supported years 2000+.

Response

saints[].id is usually a numeric source id from data/source.csv, but algorithmically calculated commemorations may use a stable string id.

Each saints[] item also includes icons[], mirroring the same icon contract as /hymnography: relative path, absolute url, localized title/description, and optional metadata.

For each saints[] item, type and types expose the legacy classification from the CSV type field. They are retained for compatibility and must not be interpreted as the liturgical rank. Some source-backed entries may also include optional presentation classification fields:

displayTypeId: numeric value from CSV display_type
displayTypes: structured labels for displayTypeId

Consumers that need display placement, such as banner grouping, may use displayTypeId ?? Number(type). The type query parameter always filters by legacy type, not displayTypeId.

liturgicalRank is always present. It is an object with code, group, and a lang-localized label, or null when the rank has not been confirmed. Supported codes are great, vigil, polyeleos, doxology, six_stichera, and no_sign.

{
  "meta": {
    "from": "2026-04-25",
    "to": "2026-04-25",
    "count": 1,
    "lang": "ru"
  },
  "data": {
    "2026-04-25": {
      "gregorian_date": "2026-04-25",
      "julian_day": 12,
      "julian_month": 4,
      "day_of_week": "Суббота",
      "saints": [
        {
          "id": 735,
          "name": "Воспоминание перенесения честного пояса Богоматери в Константинополь (942)",
          "type": "16",
          "types": [{ "id": 16, "label": "Богородичные праздники" }],
          "displayTypeId": 101,
          "displayTypes": [{ "id": 101, "label": "Исторические события" }],
          "liturgicalRank": null,
          "icons": []
        }
      ]
    }
  }
}

Example (JavaScript)

fetch(`https://api.ispovednik.org/api/v1/saints/day/2026-04-25?lang=en`)
  .then(response => response.json())
  .then(data => console.log(data));