Welcome to the Catholic Readings API

This API provides access to various Catholic readings and content.

Usage

All API endpoints require an API key. Include it as a query parameter: ?api_key=YOUR_API_KEY.

Available Endpoints

List available content keys.

GET /api/v1/content?api_key=YOUR_API_KEY

Get the daily readings content.

GET /api/v1/content/daily_readings?api_key=YOUR_API_KEY

Get the sunday homily content.

GET /api/v1/content/sunday_homily?api_key=YOUR_API_KEY

Get the saint of the day content.

GET /api/v1/content/saint_of_the_day?api_key=YOUR_API_KEY

Get the next sunday reading content.

GET /api/v1/content/next_sunday_reading?api_key=YOUR_API_KEY

Get the next sunday reading irish content.

GET /api/v1/content/next_sunday_reading_irish?api_key=YOUR_API_KEY

Get the daily readings irish content.

GET /api/v1/content/daily_readings_irish?api_key=YOUR_API_KEY

Get the mass reading details content.

GET /api/v1/mass_reading_details?api_key=YOUR_API_KEY

Mass reading details are also available at /api/v1/content/mass_reading_details.

Updates

Content refreshes automatically each day and after 12 hours. If a source is temporarily unavailable, the last successful content remains available with an X-Content-Stale: true header.

API requests are limited to 50 per hour per IP and endpoint; content keys share an endpoint limit.