Non-Working Days

API

Free database of ICS files for global non-working days

Overview

A public database of ICS (iCalendar) files containing non-working days (holidays, public observances) for various countries and regions. Users access raw ICS files directly via GitHub's raw content URLs (e.g., https://raw.githubusercontent.com/gadael/icsdb/master/[country]/[region].ics). Ideal for integrating into calendar apps (Google Calendar, Outlook), leave management systems, or scheduling tools to avoid non-working days. Data is community-maintained and formatted in ICS, a widely supported text-based calendar standard.

Example Integration (JavaScript)

script.js JS


fetch('https://github.com/gadael/icsdb')
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

Key Features

ICS file format support
Global region coverage
No authentication required
Direct raw file access
Community-maintained data

Frequently Asked Questions

? Is Non-Working Days free to use?

Yes, all ICS files are publicly accessible via the GitHub repository at no cost.

? Does it require an API Key?

No API key is needed—you can directly access raw ICS files using GitHub's raw content URLs.

? What is the response format?

Data is provided in ICS (iCalendar) format, a standard text-based format for calendar events.

Top Alternatives

Holiday API Search Google

Nager.Date Compare

Calendarific Compare

Tool Info

Pricing Free

Category Calendar

Platform Public API

Pros

⊕ Completely free to use
⊕ Easy integration with calendar tools
⊕ Open source repository
⊕ Regular community updates

Cons

⊖ No REST API endpoints (file access only)
⊖ Limited to ICS format (no JSON/XML)
⊖ Data accuracy depends on community contributions
⊖ Subject to GitHub raw content rate limits