Calendar Range Endpoint

Get full liturgical calendar data for a custom range of dates.

Request

GET /calendar/range

Parameters:

Parameter	Type	In	Description
`from`	string	query	Start date in `YYYY-MM-DD` format.
`to`	string	query	End 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.
Maximum range is 366 days.
from must be before or equal to to.

Response

Each day entry includes weekAfterPentecost as an always-present numeric Pentecost-cycle week.

All id-backed entities inside saints[] and events[] include icons[] with the same shape as /calendar/day/{date} and /hymnography.

{
  "meta": {
    "from": "2024-01-01",
    "to": "2024-01-07",
    "count": 7,
    "lang": "ru"
  },
  "data": {
    "2024-01-01": { /* ... */ },
    // ...
    "2024-01-07": { /* ... */ }
  }
}

Example (JavaScript)

const from = '2024-01-01';
const to = '2024-01-07';
fetch(`https://api.ispovednik.org/api/v1/calendar/range?from=${from}&to=${to}&lang=en`)
  .then(response => response.json())
  .then(data => console.log(data));