Non-Working Days API

⭐ Beginner's Pick Calendar / No Auth Required Beginner HTTPS
Free to Use Varies (check documentation)

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

Non-Working Days data via REST API
JSON-formatted response data
Freely accessible without authentication

Example Response

JSON 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

404 Not Found Incorrect country code or file path in the URL
Browse the GitHub repo at https://github.com/gadael/icsdb to find the exact file paths available for your target country.
CORS error in browser GitHub's CDN may block cross-origin requests depending on how the file is fetched
Download the ICS file server-side and serve it from your own domain, or use a proxy.
Calendar app will not import the file The ICS file was fetched as an HTML redirect rather than raw content
Use the raw.githubusercontent.com URL, not the github.com/blob URL.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 20/20
🔒 Security 15/15
🛠 Developer XP 15/20
✓ Reliability 7/15
Response Time 72ms

Fully tested on Apr 5, 2026

Technical Specifications

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

Similar APIs

View All →