The Rosary

Religion API · Works globally · Catholic rosary prayers · No API key

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()
Joyful Mysteries: 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