Saints Year Endpoint

Get saints data for a full year.

Request

GET /saints/year/{year}

Parameters:

Parameter	Type	In	Description
`year`	integer	path	Year in `YYYY` format.
`lang`	string	query	`ru` (default) or `en`.
`type`	integer	query	Filter by canonical taxonomy ID (`type`).

Constraints: supported years 2000+.

Response

Data object keyed by date, containing saints data for each day of the year.

Each day has the same shape as the /saints/day/{date} endpoint:

gregorian_date (string)
julian_day (number)
julian_month (number)
day_of_week (string)
saints (array of { id, name, type, types, icons }, plus optional displayTypeId and displayTypes)

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": {
    "year": 2025,
    "from": "2025-01-01",
    "to": "2025-12-31",
    "count": 365,
    "lang": "ru"
  },
  "data": {
    "2025-01-01": { /* ... */ }
  }
}

Example (JavaScript)

fetch(`https://api.ispovednik.org/api/v1/saints/year/2024?lang=en`)
  .then(response => response.json())
  .then(data => console.log(data));