Saints Range Endpoint

Get saints data for a range of dates.

Request

GET /saints/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 by canonical taxonomy ID (`type`).

Constraints:

Supported years 2000+.
Maximum range is 366 days.
from must be before or equal to to.

Response

Data object keyed by date, containing saints data for each day in the requested range.

Each saints[] item inside each day entry includes icons[] with the same shape as /saints/day/{date} and /hymnography.

In saints[], type and types are canonical taxonomy fields derived from CSV type. Source-backed entries may also include optional presentation fields displayTypeId and displayTypes derived from CSV display_type; consumers may use displayTypeId ?? Number(type) for display placement. The type query parameter filters only by canonical type.

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

Example (JavaScript)

fetch(`https://api.ispovednik.org/api/v1/saints/range?from=2024-01-01&to=2024-01-14&lang=en`)
  .then(response => response.json())
  .then(data => console.log(data));