Calendar Day Endpoint

Get full liturgical calendar data for a specific date, including saints, fasting rules, movable feasts, and commemorative days.

Request

GET /calendar/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 saints by taxonomy ID.

Constraints: supported years 2000–3000.

Response

Returns a JSON object containing metadata and a data object keyed by the requested date.

Each calendar day entry includes weekAfterPentecost as a raw numeric week index for the active Pentecost cycle. It is always present, always positive, and is not suppressed during Great Lent or the Paschal cycle.

All id-backed entities in the response mirror icons[]:

every item in saints[]
every item in events[]

The icons[] contract matches /hymnography: relative path, absolute url, localized title/description, and optional metadata.

Movable special entries with kind: "saint" and kind: "icon_of_mother_of_god" are normalized into saints[]:

saint entries are inserted at the beginning of saints[]
icon_of_mother_of_god entries are inserted as the first item inside the typeId: 17 group
these inserted entries use string IDs (movable IDs), so saints[].id can be number or string
a special entry is removed from events[] only if it is included in saints[] for the current type filter
when excluded by type, it remains in events[] with its original kind (saint / icon_of_mother_of_god)

Inside fasting, the optional field allowedFood is returned only when the day has a concrete meal allowance. Possible values:

ru: Пища без мяса, Рыба, горяч. пища с раст. маслом, Горяч. пища с раст. маслом, Горяч. пища без раст. масла, Сухоядение. Холод. пища без раст. масла, неподогретое питьё, Воздержание от пищи, разрешается икра
en: meat-free food, fish, hot food with vegetable oil, hot food with vegetable oil, hot food without vegetable oil, cold food without vegetable oil, unheated drink, abstinence from food, caviar

{
  "meta": {
    "from": "2026-02-28",
    "to": "2026-02-28",
    "count": 1,
    "lang": "ru"
  },
  "data": {
    "2026-02-28": {
      "gregorianDate": "2026-02-28",
      "julianDate": "2026-02-15",
      "dayOfWeek": "Суббота",
      "weekAfterPentecost": 38,
      "saints": [
        {
          "id": "theodore_tyron_saturday_first_week_lent",
          "name": "Вмч. Феодора Тирона (переходящее празднование в субботу 1-й седмицы Великого поста)",
          "typeId": 7,
          "types": [{ "id": 7, "label": "Праздники" }],
          "icons": []
        }
      ],
      "fasting": {
        "isFasting": true,
        "type": "FAST",
        "isSolidWeek": false,
        "description": "Великий пост",
        "allowedFood": "Горяч. пища с раст. маслом"
      },
      "events": [
        {
          "kind": "week",
          "id": "first_week_lent",
          "dateFrom": "2026-02-23",
          "dateTo": "2026-02-28",
          "label": "Седмица 1-я Великого поста. Торжество Православия",
          "icons": []
        }
      ]
    }
  }
}

Example (JavaScript)

const date = '2026-02-28';
fetch(`https://api.ispovednik.org/api/v1/calendar/day/${date}?lang=en`)
  .then(response => response.json())
  .then(data => console.log(data));