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": "test@example.com",
  "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

Request
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.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

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

Related Tags

Similar APIs

View All →