The Rosary API

Daily Rosary prayers, aligned with the Roman Catholic liturgical calendar — available in English and French.

Overview

The Rosary API is a JavaScript‑based service that provides the Roman Catholic daily Rosary prayers for any date in the current year.
It automatically selects the appropriate set of mysteries according to:

• Weekday tradition (Joyful, Sorrowful, Glorious, Luminous)
• Liturgical season (Advent, Christmas, Epiphany, Ordinary Time, Lent, Easter)

Season	Sub-Periods
Advent	Early Advent, Late Advent (O Antiphons)
Christmas	Christmas Octave, Post-Octave, Epiphanytide, Baptism of the Lord
Ordinary Time I	Weeks 1–6
Lent	Early Lent, Weeks 1–5, Holy Week, ends before Holy Thursday evening
Triduum	Holy Thursday evening, Good Friday, Holy Saturday, Easter Vigil
Easter	Easter Octave, Weeks 2–7, Ascension, Pentecost
Ordinary Time II	Weeks 7/8–34, Trinity, Corpus Christi, Sacred Heart, Christ the King

Key Transitions

• The Triduum: Though short, this is the "summit" of the liturgical year, bridging the end of Lent and the beginning of the Easter season.
• Ordinary Time: This season is divided into two parts by the movable dates of Lent and Easter, focusing on the life and teachings of Christ.
• The O Antiphons: These occur in the final week of Advent (December 17–23), marking the immediate preparation for the Nativity.

Core behavior

Here’s the Rosary mysteries schedule organized by day, with Sundays adapting to the liturgical season for deeper reflection:

• Monday: Joyful Mysteries
• Tuesday: Sorrowful Mysteries
• Wednesday: Glorious Mysteries
• Thursday: Luminous Mysteries
• Friday: Sorrowful Mysteries
• Saturday: Joyful Mysteries
• Sunday (Ordinary Time): Glorious Mysteries
• Sunday (Advent): Joyful Mysteries
• Sunday (Christmas): Joyful Mysteries
• Sunday (Lent): Sorrowful Mysteries

This makes it easy to integrate daily Rosary content into apps, websites, or devotional tools.

Features

• 📅 Daily prayers based on the current date
• ⛪ Liturgical season awareness (Advent, Lent, Easter, etc.)
• 🌍 Localization: English (en) and French (fr)
• 🔗 Simple REST API endpoint
• 🕊️ Structured JSON output with mysteries, prayers, and seasonal notes

Installation (Optional for Local Development)

git clone https://github.com/erickouassi/The-Rosary-Api.git
cd The-Rosary-Api
npm install
npm start

Endpoint & API Usage

Go to: https://therosaryapi.cf/

Contributing

Contributions are welcome!

• Fork the repository
  
• Create a feature branch
  
• Submit a pull request

Quick Start

You can call the Rosary API from any JavaScript or Node.js application using fetch.

Example with fetch

// Fetch today's Rosary in English
fetch('https://the-rosary-api.vercel.app/v1/today')
  .then(res => res.json())
  .then(data => {
    if (data && data.length > 0) {
      const today = data[0]; // first item in the array
      console.log('Today date:', today.rosary_date);   // or today.currentDate for full text
      console.log('Season:', today.season);
      console.log('Mystery Set:', today.mystery);
    }
  })
  .catch(err => console.error('API fetch error:', err));

### Output Example ###
Today date: 2025-12-16
Season: Advent
Mystery Set: Sorrowful

Prototype Reference

The Rosary API powers devotional tools like https://dailyrosary.cf, a prototype web app that demonstrates how the API can be used to:

• Fetch the daily Rosary prayers automatically
• Detect the liturgical season (Advent, Christmas, Lent, Easter, etc.)
• Display the correct set of mysteries for the day

This prototype can serve as inspiration for building your own apps, parish websites, or prayer group resources.