🙏 Catholic Readings API

Free, open-source REST API for Catholic liturgical data

✨ No Rate Limits 🔓 Open Source 📱 CORS Enabled ⚡ GitHub Pages
Get Started View on GitHub

🎯 Mission

To provide the Catholic developer community with reliable, free access to liturgical data for building apps, websites, and tools that serve the faithful worldwide.

📖

Daily Mass Readings

First Reading, Psalm, Second Reading, Gospel

👑

Saints & Feast Days

Complete calendar with quotes and biographies

🗓️

Liturgical Seasons

Ordinary Time, Advent, Christmas, Lent, Easter

🔗

USCCB Verification

Direct links to official USCCB readings

🚀 Quick Start

Try the API Live!

Click the buttons below to fetch real data:

📖 Get Daily Readings

GET /readings/2025/MM-DD.json 
fetch('https://cpbjr.github.io/catholic-readings-api/readings/2025/09-07.json')
  .then(response => response.json())
  .then(data => console.log(data));

👑 Get Saint Information

GET /saints/2025/MM-DD.json 
fetch('https://cpbjr.github.io/catholic-readings-api/saints/2025/09-08.json')
  .then(response => response.json())
  .then(data => console.log(data));

📊 Data Coverage

📈 Statistics

  • 247 Total Entries - Complete liturgical data
  • 43 Daily Readings - August through December 2025
  • 204 Saints & Feasts - Throughout the year
  • All Liturgical Seasons - Complete coverage

🎖️ Liturgical Rankings

  • Solemnities - Christmas, Epiphany, Assumption
  • Feasts - Apostles, Evangelists, major saints
  • Memorials - Obligatory commemorations
  • Optional Memorials - Saints that may be celebrated

💡 Use Cases

⛪ Parish Websites

Display daily readings on your parish homepage. Perfect for bulletin integration and member engagement.

📱 Mobile Apps

Build Catholic prayer apps with daily readings, saint information, and liturgical calendar integration.

🎓 Educational Tools

Create learning platforms for Catholic schools, RCIA programs, and faith formation resources.

📰 Automated Content

Generate bulletins, newsletters, and social media posts with current liturgical data.

🛠️ Response Examples

📖 Readings Response

{
  "date": "2025-09-07",
  "monthDay": "9/7",
  "season": "Ordinary Time",
  "readings": {
    "firstReading": "Wisdom 9:13-18b",
    "psalm": "Psalm 90:3-4, 5-6, 12-13, 14 and 17",
    "secondReading": "Philemon 9-10, 12-17",
    "gospel": "Luke 14:25-33"
  },
  "usccbLink": "https://bible.usccb.org/bible/readings/090725.cfm",
  "apiEndpoint": "https://cpbjr.github.io/catholic-readings-api/readings/2025/09-07.json"
}

👑 Saint Response

{
  "date": "2025-09-08",
  "monthDay": "9/8",
  "saint": {
    "name": "Birth of Mary",
    "type": "Feast",
    "quote": "Rejoice, O highly favored daughter! The Lord is with you.",
    "description": "Celebrates the birth of the Mother of God."
  },
  "wikipediaLink": "https://en.wikipedia.org/wiki/Birth_of_Mary",
  "apiEndpoint": "https://cpbjr.github.io/catholic-readings-api/saints/2025/09-08.json"
}

🤝 Contributing

We welcome contributions from the Catholic developer community! Help us improve and expand this resource:

Contribute on GitHub