Parish Companion Ordo

What is Parish Companion Ordo?

Parish Companion Ordo is a free, open-source REST API that returns Roman Catholic liturgical calendar data for any date. It covers the General Roman Calendar plus national and diocesan proper calendars, with Australia supported from launch.

Built by a parish coordinator for the Catholic developer community — because accurate, free liturgical data should be available to everyone building tools that serve the faithful.

Liturgical Seasons

Advent, Christmas, Lent, Holy Week, Easter, and Ordinary Time — correctly calculated for any year.

Feasts & Solemnities

Full feast calendar including rank, liturgical colour, and feast transfer logic when clashes occur.

National Calendars

Country-specific proper feasts layered on top of the universal Roman calendar.

Lectionary Cycles

Sunday cycle (A/B/C) and weekday cycle (I/II) calculated correctly for any date.

Australian Proper

Our Lady Help of Christians, Saint Mary of the Cross, Saint Peter Chanel, and all Australian feasts.

Open & Free

MIT licensed, no API key required, no rate limits. Use it in any project, commercial or otherwise.

API Endpoints

The base URL for all requests is https://api.parishcompanion.app

API Information

GET https://api.parishcompanion.app

List Supported Countries

GET https://api.parishcompanion.app/countries

Full Year Calendar

GET https://api.parishcompanion.app/calendar/{country}/{year}

# Example
GET https://api.parishcompanion.app/calendar/AU/2026

Single Date Lookup

GET https://api.parishcompanion.app/calendar/{country}?date=YYYY-MM-DD

# Example
GET https://api.parishcompanion.app/calendar/AU?date=2026-08-08

Example Response

{
  "country": "AU",
  "date": "2026-08-08",
  "day": {
    "date": "2026-08-08",
    "season": "ordinary",
    "colour": "white",
    "rank": "feast",
    "name": "Saint Mary of the Cross",
    "australian": true,
    "secular": null,
    "sunday_cycle": "A",
    "weekday_cycle": "II"
  }
}

Supported Countries

Parish Companion Ordo launches with Australia and will expand as contributions are made.

🇦🇺 Australia 🇳🇿 New Zealand — coming soon 🇵🇭 Philippines — coming soon 🇮🇪 Ireland — coming soon 🌍 More — contribute yours!

Contributing

Parish Companion Ordo is built on community contributions. Each country's proper calendar is stored as a JSON data file — if you know your national calendar, you can contribute it.

Calendar data lives in data/calendars/ in the GitHub repository. The Australian calendar (AU-en.json) is a good reference for the data format. Contributions are reviewed for liturgical accuracy before merging.

Whether you're a developer, a liturgy coordinator, or just someone who wants accurate Catholic calendar data for your country — contributions are welcome.

View on GitHub Request a Country

The Parish Companion Suite

Parish Companion Ordo is part of a growing suite of tools for Catholic parishes.

Live

Liturgical calendar API for developers. You are here.

Live

Parish Companion

Ministry roster and volunteer management for parish coordinators.

Coming Soon

Parish Companion Music

Lectionary-aware music selection tool for liturgy coordinators.