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 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 ?? typeId. The type query parameter always filters by legacy typeId, 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.

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). The unique movable ID anna_kashinskaya is computed on the Sunday after July 12 for Venerable Anna of Kashin; no separate Synaxis event is emitted. Fixed saint ID 1372 remains the first finding of her relics on July 21 in the Julian calendar (August 3 through 2099). Content endpoints resolve the movable ID to the same texts and icons while preserving anna_kashinskaya in their response.

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