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 canonical taxonomy 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 describe the canonical taxonomy from the CSV type field. 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 canonical type, not displayTypeId.

{
  "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": "Исторические события" }],
          "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));