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.
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.
{
"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.
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.
Metadata Score Breakdown
Estimated from metadata — endpoint not independently tested
Metadata estimate · endpoint not independently tested
Technical Specifications
Related Tags
Similar APIs
View All →Church Calendar
⭐ Beginner's PickChurch Calendar (calapi.inadiutorium.cz) is a free, no-auth REST API that returns the Roman Catholic liturgical calendar for any date or month.
Czech Namedays Calendar
⭐ Beginner's PickThe Czech Namedays Calendar API lets you look up the Czech or Slovak nameday (svátek) associated with a given first name, or find whose nameday falls on a specific date.
Hebrew Calendar
⭐ Beginner's PickThe Hebcal API provides free Jewish calendar data including Hebrew date conversions, Shabbat candle-lighting times, Jewish holidays, and weekly Torah portion readings.
LectServe
⭐ Beginner's PickLectServe is a free REST API that returns Revised Common Lectionary readings — Scripture passages assigned to each Sunday and feast day used by many Protestant denominations.
Nager.Date
⭐ Beginner's PickNager.Date is a completely free, open-source REST API providing public holidays for over 90 countries with no API key required.