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

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

Request
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.

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 UNKNOWN
Category Calendar
Difficulty Beginner
Verified: 2026-04-04

Related Tags

Similar APIs

View All →