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 taxonomy ID. |
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 })
{
"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));