Russian Calendar API

Free to Use Varies (check documentation)

Overview

Russian Calendar API checks whether a specific date is a holiday, working day, or short day in Russia, based on official government decree data. It is hosted as a self-deployable Node.js service with a public endpoint available. The API is particularly useful for payroll systems, scheduling apps, and HR tools targeting Russian users.

💡

Beginner Tip

Clone the GitHub repo and run it locally first to understand the data format before integrating a hosted instance. The response returns an array of day-type codes for an entire month, which you can use to build a full calendar view.

Available Data

event dates and names
holiday lists by country
date metadata

Example Response

JSON Response
{
  "input": "[email protected]",
  "is_valid": true,
  "format_valid": true,
  "details": "Input passes all validation checks"
}

Field Reference

year The year of the calendar data returned
month The month number (1-12) for the returned data
days Array of day-type codes for each day of the month: 0 = working day, 1 = holiday, 2 = short day
holidays List of named holidays within the requested month with their dates and official names

Implementation Example

const url = "https://github.com/egno/work-calendar";
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 year or month in the request path or query
Use a four-digit year and a two-digit zero-padded month as query parameters: ?year=2025&month=01
CORS error from browser The public hosted instance may not enable CORS for all origins
Self-host the service using Docker or Node.js so you control CORS headers, or proxy requests through your backend.
Stale or incorrect holiday data Russia sometimes changes official holiday schedules mid-year by government decree
Update to the latest version of the GitHub repo before deploying each year to get current data.

Matrix Score Breakdown

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

Fully tested on Apr 5, 2026

Technical Specifications

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

Similar APIs

View All →