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
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.
{
"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
Calls a real endpoint of this API. Replace any placeholder credentials with your own key.
const url = "https://raw.githubusercontent.com/gadael/icsdb/master/fr.ics";
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.