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

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

event dates and names
holiday lists by country
date metadata

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative
{
  "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

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request
const url = "https://work-calendar.ru/api/v1/calendar?year=2025&month=01";
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

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

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
Listing details not endpoint-verified

Related Tags

Similar APIs

View All →