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 taxonomy ID.

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.

{
  "meta": {
    "from": "2025-01-07",
    "to": "2025-01-07",
    "count": 1,
    "lang": "ru"
  },
  "data": {
    "2025-01-07": {
      "gregorian_date": "2025-01-07",
      "julian_day": 25,
      "julian_month": 12,
      "day_of_week": "Вторник",
      "saints": [
        {
          "id": 42,
          "name": "Рождество Господа Нашего Иисуса Христа",
          "type": "1",
          "types": [{ "id": 1, "label": "Великие праздники" }],
          "icons": []
        }
      ]
    }
  }
}

Example (JavaScript)

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