Orthodox Calendar API

Welcome to the Orthodox Calendar API documentation. This API provides data for the Orthodox liturgical calendar, including saints, feasts, fasting rules, and movable feasts (Easter/Pascha).

Base URL: https://api.ispovednik.org/api/v1

About This Calendar

This calendar follows the ROCOR calendar in the latest edition known before the 2007 split.

The published calendar used by this API excludes:

the commemoration of confessor Yakov Arkatov;
the commemoration of new martyr Boris Talantov.

Reference (Russian): Definition of the Bishops' Council of the Russian Orthodox Church on the decanonization of Boris Talantov.

Common Parameters

Parameter	Type	Description
`lang`	string	Language code: `ru` (default) or `en`.
`type`	integer	Filter saints by taxonomy ID (e.g., `1` for Great Feasts).

Constraints & Limits

Calendar + Saints: supported for years 2000+.
Fasting + Movable Feasts: supported for years 1583–3000.
Memorial days: supported for years 1583–4000.
Date range endpoints (/range): maximum 366 days.
Movable range (/movable/range): maximum 100 years.
Hymnography ids per request (/hymnography): maximum 24 ids.

Available Resources

The API is organized into several resources. Click a resource to view detailed documentation.

JavaScript SDK

Browser-first client library for API consumers.

Change Log

A selective, manually maintained log of calendar data and documentation updates.

Forefeast/Afterfeast/Leave-taking Table (working reference, RU)

Normalized text version of the reference table and the corresponding calculation logic used by the API.

OpenAPI 3.1 Viewer

Interactive docs: /openapi/index.html
Raw spec: /openapi/v1.json

Per-feed OpenAPI Reference

Saints (RU): /docs/openapi/saints/
Saints (EN): /docs/en/openapi/saints/
Pascha & Movable Feasts (RU): /docs/openapi/pascha/
Pascha & Movable Feasts (EN): /docs/en/openapi/pascha/
Fasting (RU): /docs/openapi/fasting/
Fasting (EN): /docs/en/openapi/fasting/
Hymnography (RU): /docs/openapi/hymnography/
Hymnography (EN): /docs/en/openapi/hymnography/

Raw feed specs:

/openapi/saints.v1.ru.json
/openapi/saints.v1.en.json
/openapi/pascha.v1.ru.json
/openapi/pascha.v1.en.json
/openapi/fasting.v1.ru.json
/openapi/fasting.v1.en.json
/openapi/hymnography.v1.ru.json
/openapi/hymnography.v1.en.json

Unified Calendar

The canonical feed combining all data types.

Day: /calendar/day/{date}
Year: /calendar/year/{year}
Month: /calendar/month/{year}/{month}
Range: /calendar/range

Saints & Feasts

Data specifically about saints and fixed holidays.

Day: /saints/day/{date}
Year: /saints/year/{year}
Month: /saints/month/{year}/{month}
Range: /saints/range

Fasting

Fasting rules and periods.

Day: /fasting/day/{date}
Year: /fasting/year/{year}
Month: /fasting/month/{year}/{month}
Range: /fasting/range

Movable Feasts

Easter (Pascha) and related movable feasts.

Day: /movable/day/{date}
Year: /movable/year/{year}
Range: /movable/range

Memorial Days

Days of remembrance for the departed.

Year: /memorial/year/{year}

Hymnography

Troparia, kontakia, prayers, magnifications, and hagiographies by internal ids.

By ids: /hymnography/?id=...&id=...