API Documentation
The Coptic Calendar API provides access to liturgical data via REST and GraphQL.
Base URL
https://api.coptic.io/apiGraphQL
/graphqlCalendar
Convert dates between Gregorian and Coptic calendars
/calendarGet today's Coptic date
/calendar/:dateConvert a specific date to Coptic
Params: date: YYYY-MM-DD
/calendar/month/:year/:monthGet calendar month data
/calendar/ical/:yearGet iCalendar feed for a year
/calendar/ical/subscribeSubscribe to live iCal feed
/calendar/ical/infoGet iCal subscription info
Readings
Daily scripture readings from the Katameros
/readingsGet today's readings
/readings/:dateGet readings for a specific date
Params: date: YYYY-MM-DD
/readings/:date?detailed=trueGet readings with full verse text
Celebrations
Feast days and celebrations
/celebrationsList all celebrations
/celebrations/:dateGet celebrations for a specific date
/celebrations/upcoming/listGet upcoming celebrations
Params: days: number (default: 30)
Fasting
Fasting periods and status
/fasting/:dateCheck if a date is a fasting day
/fasting/calendar/:yearGet full year fasting calendar
Seasons
Liturgical seasons
/seasonGet today's liturgical season
/season/:dateGet season for a specific date
/season/year/:yearGet all seasons for a year
Synaxarium
Saint commemorations
/synaxarium/:dateGet saints for a specific date
/synaxarium/coptic/:copticDateGet saints by Coptic date
Params: copticDate: e.g. "7 Toba"
/synaxarium/search/querySearch saints by name
Params: q: search term
Agpeya
Coptic Book of Hours prayers
/agpeyaGet current prayer hour
/agpeya/hoursList all prayer hours
/agpeya/:hourGet specific hour
Params: hour: prime|terce|sext|none|vespers|compline|midnight
/agpeya/midnight/watch/:watchGet midnight watch
Params: watch: 1|2|3
Search
Unified search across all content
/searchSearch Bible, Synaxarium, and Agpeya
Params: q: query, limit?: number, categories?: bible,synaxarium,agpeya