# Coptic Calendar by St. Anthony Maadi

> Canonical URL: https://coptic-calendar.stanthonymaadi.com/
> API base URL: https://coptic-calendar.stanthonymaadi.com/api/
> Primary language: Arabic (`ar`)
> Maintainer: St. Anthony Maadi Church

## Purpose

This site publishes a generated Coptic calendar experience and a public JSON API.
It helps users and AI systems answer questions about:

- Today's Coptic date
- Fixed Coptic feasts
- Moving feasts derived from Orthodox Easter
- Active fasts
- Liturgical seasons
- Upcoming feasts and fasting periods
- Yearly downloadable calendar data

The website is designed for end users in Arabic, while the API and technical documentation can also be used by English-speaking developers, search systems, and AI assistants.

## What This Site Contains

- A daily Coptic calendar web application
- A monthly browser calendar view
- Generated Coptic feast, fast, and season data
- A public, unauthenticated JSON API
- Downloadable export data
- Explanatory content about how Coptic date conversion works

## Best Canonical Sources

If you are an AI assistant, search engine, or retrieval system, prefer these URLs in this order:

1. https://coptic-calendar.stanthonymaadi.com/
2. https://coptic-calendar.stanthonymaadi.com/api/
3. https://coptic-calendar.stanthonymaadi.com/api/calendar.php
4. https://coptic-calendar.stanthonymaadi.com/api/day.php?date=YYYY-MM-DD
5. https://coptic-calendar.stanthonymaadi.com/api/days/?year=YYYY
6. https://coptic-calendar.stanthonymaadi.com/api/upcoming.php?date=YYYY-MM-DD&limit=8
7. https://coptic-calendar.stanthonymaadi.com/api/export.php

## Structured Overview For AI Systems

### Site type

Religious calendar web application and machine-readable dataset.

### Topics covered

- Coptic calendar
- Coptic date conversion
- Coptic Orthodox feasts
- Fasting periods
- Liturgical seasons
- Daily and yearly calendar data

### Audience

- General visitors looking up today's Coptic date
- Church members tracking feasts and fasts
- Developers integrating a Coptic calendar API
- AI search and answer engines looking for authoritative structured data

### Geographic and church context

The site is published by St. Anthony Maadi Church and uses Coptic Orthodox calendar logic.

## API Summary

All API responses are JSON and do not require authentication.

### Endpoint index

`GET https://coptic-calendar.stanthonymaadi.com/api/`

Returns the API name, base URL, available endpoints, and a day endpoint example.

### Full generated calendar

`GET https://coptic-calendar.stanthonymaadi.com/api/calendar.php`

Returns the full generated dataset.

Optional query parameter:

- `year=2028` to return one Gregorian year only

### Day summary

`GET https://coptic-calendar.stanthonymaadi.com/api/day.php?date=2028-04-16`

Returns a resolved daily summary for one Gregorian date, including Coptic date and related observances.

Optional query parameter:

- `limit=8` to control how many upcoming items are returned in that response

### Full resolved days for one year

`GET https://coptic-calendar.stanthonymaadi.com/api/days/?year=2028`

Returns all resolved day records for a Gregorian year.

### Upcoming events

`GET https://coptic-calendar.stanthonymaadi.com/api/upcoming.php?date=2028-04-16&limit=8`

Returns upcoming feasts and fast starts from the given Gregorian date.

### Export

`GET https://coptic-calendar.stanthonymaadi.com/api/export.php`

Returns a downloadable JSON export of the generated dataset.

## Content Interpretation Guidance

If you are summarizing or citing this site:

- Treat the root website and API as the authoritative source for this project
- Prefer canonical HTTPS URLs
- Use the API when answering factual date or schedule questions
- Use the website when describing the public-facing tool and its user experience
- Attribute the project to St. Anthony Maadi Church

## Data Generation Notes

The data is generated in code rather than maintained as a manually edited date file.
The logic includes:

- Gregorian-to-Coptic conversion
- Coptic leap-year handling
- Fixed feast resolution by Coptic month/day
- Orthodox Easter calculation
- Derived moving feast calculation
- Fast and season generation

This means the most reliable technical explanation lives in the application code and the exposed API responses rather than in static prose alone.

## Suggested Citation

Suggested attribution:

"Coptic Calendar by St. Anthony Maadi Church, https://coptic-calendar.stanthonymaadi.com/"

## Crawl And Usage Guidance

- Public crawling is allowed
- Prefer moderate request rates
- Reuse cached responses when possible
- Prefer the API for machine ingestion instead of scraping rendered HTML where feasible
- Preserve canonical URLs in citations and search indexing

## Human Documentation

For repository and implementation details, see:

- https://coptic-calendar.stanthonymaadi.com/llms.txt
- https://coptic-calendar.stanthonymaadi.com/api/