TL;DR
The Rosary API provides the complete text of Catholic rosary prayers, including all four sets of mysteries (Joyful, Sorrowful, Glorious, and Luminous). Each mystery includes the scriptural reference, meditation text, and the full prayer sequence. Access prayers for each decade, opening/closing prayers, and the Litany of Loreto. JSON format with bilingual support. No API key. Perfect for Catholic prayer apps, daily devotional tools, and religious education platforms.
Quick start: https://therosaryapi.herokuapp.com/api/v1/mysteries/joyful
No API key needed — just make a request!
How to Use This API
1. Get All Mysteries
https://therosaryapi.herokuapp.com/api/v1/mysteries
2. Get a Specific Mystery Set
https://therosaryapi.herokuapp.com/api/v1/mysteries/joyful
3. JavaScript — Daily Rosary Prayer
const day = new Date().getDay();
const mysterySets = ['joyful', 'sorrowful', 'glorious', 'luminous'];
const setForToday = mysterySets[day % 4];
fetch(`https://therosaryapi.herokuapp.com/api/v1/mysteries/${setForToday}`)
.then(r => r.json())
.then(data => {
console.log(`Today's Mysteries: ${data.title}`);
data.mysteries.forEach(m => {
console.log(`\n${m.number}. ${m.title}`);
console.log(`Scripture: ${m.scripture}`);
console.log(`Fruit: ${m.fruit}`);
});
});
4. Python — Print a Full Rosary Set
import requests
data = requests.get(
'https://therosaryapi.herokuapp.com/api/v1/mysteries/glorious'
).json()
print(f"=== {data['title']} ===\n")
for m in data['mysteries']:
print(f"{m['number']}. {m['title']}")
print(f" Scripture: {m['scripture']}")
print(f" Meditation: {m.get('meditation', 'N/A')[:100]}...")
print(f" Prayer intention: {m['fruit']}")
print()
https://therosaryapi.herokuapp.com/api/v1/mysteries/joyful
Frequently Asked Questions
- What mystery sets are available?
- Joyful (Monday/Saturday), Sorrowful (Tuesday/Friday), Glorious (Wednesday/Sunday), and Luminous (Thursday). Each contains 5 mysteries.
- What data is included per mystery?
- Number, title, scripture reference, meditation text, prayer intention/fruit, and the full decade prayers (Our Father, 10 Hail Marys, Glory Be).
- Does the API include the full prayer text?
- Yes, including Apostles' Creed, Our Father, Hail Mary, Glory Be, Fatima Prayer, Hail Holy Queen, and the Litany of Loreto.
- Are multiple languages supported?
- English is the primary language. Check the API documentation for additional language support and locale options.
- Can I get prayers for a specific day?
- Traditional Catholic practice assigns specific mysteries to specific days. You can use the day-based logic to serve the appropriate set.
- Is there a rate limit?
- The Rosary API is a free devotional web service hosted on Heroku. It may take a moment to wake up if unused for a while (cold start).
API Details
- API URL
https://therosaryapi.herokuapp.com/api/v1- Documentation
- therosaryapi.herokuapp.com
- Category
- Religion
- Authentication
- Not Required
- Geographic Coverage
- Global
What You Can Build
- Daily rosary app with today's mysteries and guided audio meditation
- Prayer timer app tracking time spent on each decade and mystery set
- Scripture study tool linking rosary mysteries to Bible verses
- RCIA education platform teaching the structure and meaning of the rosary
- Multi-language rosary reference with side-by-side prayer translations