Non-Working Days API
Overview
Non-Working Days provides ICS calendar files for public holidays and non-working days across many countries, hosted as a structured database on GitHub. Each country file lists official non-working days in the iCalendar format, ready to import into any calendar application. The data is served as static files, so no authentication or rate limiting applies.
Beginner Tip
Since this is a static file database, you fetch ICS files directly by URL — no API key needed. Try downloading a country file and opening it in Google Calendar to see holidays instantly.
Available Data
Example Response
{
"status": "success",
"data": {
"result": "Data from Non-Working Days",
"description": "Database of ICS files for non working days",
"timestamp": "2025-01-15T10:00:00Z"
}
} Field Reference
BEGIN:VEVENT Marks the start of a calendar event block within the ICS file DTSTART The start date of the non-working day in YYYYMMDD format DTEND The end date of the event, typically one day after DTSTART for single-day holidays SUMMARY Human-readable name of the holiday or non-working day UID Unique identifier for the event, used to avoid duplicate imports in calendar applications Implementation Example
const url = "https://github.com/gadael/icsdb";
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
Matrix Score Breakdown
Fully tested on Apr 5, 2026
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.