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:

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.

For each saints[] item, typeId 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 ?? typeId. The type query parameter always filters by canonical typeId, not displayTypeId.

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)

Examples of movable saint entries normalized this way include abraham_bulgaria_translation_relics_fourth_sunday_pascha and tabitha_joppa_fourth_sunday_pascha on 2026-05-03. Computed special saint entries follow the same rule; for example, syrian_desert_fathers_julian_february_23 is normalized into saints[] on Julian February 23 (2026-03-08 in Gregorian calendar).

Inside fasting, the optional field allowedFood is returned only when the day has a concrete meal allowance. For fasting.type = NO_FAST, the API returns an explicit no-fast description (Поста нет / No fast) so consumers do not receive a blank value. 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-04-25",
    "to": "2026-04-25",
    "count": 1,
    "lang": "ru"
  },
  "data": {
    "2026-04-25": {
      "gregorianDate": "2026-04-25",
      "julianDate": "2026-04-12",
      "dayOfWeek": "Суббота",
      "weekAfterPentecost": 46,
      "saints": [
        {
          "id": 735,
          "name": "Воспоминание перенесения честного пояса Богоматери в Константинополь (942)",
          "typeId": 16,
          "types": [{ "id": 16, "label": "Богородичные праздники" }],
          "displayTypeId": 101,
          "displayTypes": [{ "id": 101, "label": "Исторические события" }],
          "icons": []
        }
      ],
      "fasting": {
        "isFasting": true,
        "type": "NO_FAST",
        "isSolidWeek": false,
        "description": "Поста нет"
      },
      "events": [
        {
          "kind": "week",
          "id": "second_week_after_easter",
          "dateFrom": "2026-04-20",
          "dateTo": "2026-04-25",
          "label": "2-я седмица по Пасхе",
          "icons": []
        }
      ]
    }
  }
}

Example (JavaScript)

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