Church Calendar API

⭐ Beginner's Pick Calendar / No Auth Required Beginner HTTP
Free to Use Varies (check documentation)

Overview

Church Calendar (calapi.inadiutorium.cz) is a free, no-auth REST API that returns the Roman Catholic liturgical calendar for any date or month. It provides the liturgical season, feast day names, and liturgical colour for each day. No registration is needed — just send a GET request with a year, month, and optional day.

💡

Beginner Tip

No API key or sign-up required, making this one of the easiest APIs to test. Request a full month with GET http://calapi.inadiutorium.cz/api/v0/en/calendars/default/YYYY/MM.

Available Data

event dates and names
holiday lists by country
date metadata
Use case: Integrate catholic liturgical calendar data into web and mobile applications

Example Response

JSON Response
{
  "status": "success",
  "data": {
    "result": "Data from Church Calendar",
    "description": "Catholic liturgical calendar",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

[].date The calendar date in YYYY-MM-DD format.
[].season The liturgical season for that day, e.g., "advent" or "ordinary".
[].celebrations[].name Name of the feast or memorial observed on that day.
[].celebrations[].colour Liturgical colour for the celebration: "white", "red", "green", or "purple".
[].celebrations[].rank Liturgical rank of the celebration, e.g., "solemnity", "feast", or "memorial".

Implementation Example

const url = "http://calapi.inadiutorium.cz/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

404 Not Found Incorrect URL path structure or unsupported calendar name
Use the path /api/v0/en/calendars/default/YEAR/MONTH (e.g., /api/v0/en/calendars/default/2024/12).
Connection refused or SSL error The API endpoint uses plain HTTP, not HTTPS
Use http:// (not https://) in your request URL; this API does not support TLS.
Unexpected season value Unfamiliarity with liturgical season naming
Valid seasons include "advent", "christmas", "ordinary", "lent", and "easter"; refer to the API docs for the full list.

Matrix Score Breakdown

🌐 Reachability 0/30
⚡ Speed 15/20
🔒 Security 0/15
🛠 Developer XP 15/20
✓ Reliability 7/15
Response Time 291ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS NO
CORS UNKNOWN
Category Calendar
Difficulty Beginner
Verified: 2026-04-04

Similar APIs

View All →