Orthodox Calendar


Orthocal.info is an Eastern Orthodox calendar service providing a RESTful api describing commemorations, fasting, scripture readings and other information for each day of the liturgical year. Presently only the OCA is fully supported. There is tentative support for ROCOR, but fasting guidelines may not be 100% correct. With assistance, I may eventually provide support for other US jurisdictions.

This service is meant to be a tool for mobile developers and parish webmasters to use to provide this information to parishioners and other guests. Source code and a docker image for self-hosting are freely available.

Contact the Author

Orthocal.info is being provided to the Orthodox community with no strings attached. However, it is helpful to me, the author of the work, to know who is using it and how. I will then be able to know how best to support your usage of the api and will be able to keep you informed about changes or maintenance work that needs to be done. Please contact me via the contact form on my blog, Parochianus, and let me know about your usage.

Please report bugs using the Github issue tracker.

Existing Bugs

There are some known issues. For instance, the composite readings are put together based on normal scripture references. However, not all of the composite readings can be reconstructed in this way. Often they are very much paraphrased from large blocks of scripture. I need to come up with a new system for the composites to use the actual reading from the liturgical texts in order to make these more correct.


The algorithm and data used in this service are based on the algorithm and data developed by Paul Kachur's orthodox_calendar project. As such, the commemoration data is incomplete. The primary purpose of this service is to provide daily scripture readings for lay persons and not to be an authoritative guide to the feasts and fasts of the Church.


Because this is open-source and free, the service must use a translation of the Bible that is either public domain or has agreeable license terms. At this point I have chosen to stick with the King James Version. While not ideal, many clergy consider this to be one of the best options for Orthodox. Because the rubrics use Septuagint versification, a handful of the Old Testament readings may be incorrect.