Non-working Days

How to Use This API

1. Check if a Date is a Non-Working Day

https://nonworkingdays.com/api/isnonworkingday?date=2024-12-25&country=US

Returns whether the date is a non-working day, holiday name if applicable, and the day of week.

2. Get All Holidays for a Year

https://nonworkingdays.com/api/holidays?country=GB&year=2024

Returns all public holidays for a given country and year with holiday names and dates.

3. Count Working Days Between Dates

https://nonworkingdays.com/api/workingdays?country=US&start=2024-01-01&end=2024-01-31

Counts the number of working days (Monday-Friday excluding holidays) in a date range.

4. JavaScript — Deadline Calculator

async function countWorkingDays(startDate, endDate, country) {
  const resp = await fetch(
    `https://nonworkingdays.com/api/workingdays` +
    `?country=${country}&start=${startDate}&end=${endDate}`
  );
  const data = await resp.json();
  return data.workingDays;
}

async function checkDeadline() {
  const days = await countWorkingDays('2024-01-01', '2024-01-15', 'US');
  console.log(`Working days between Jan 1-15: ${days}`);
  // Returns working days (Mon-Fri excluding holidays like New Year's Day)
}

checkDeadline();

5. Python — Holiday Calendar Generator

import requests
from datetime import datetime

def get_holidays(country, year):
    resp = requests.get(
        'https://nonworkingdays.com/api/holidays',
        params={'country': country, 'year': year}
    )
    data = resp.json()
    
    print(f"Public holidays in {country} for {year}:")
    for h in data.get('holidays', []):
        date = datetime.strptime(h['date'], '%Y-%m-%d')
        print(f"  {date.strftime('%b %d')}: {h['name']}")
    
    return data.get('holidays', [])

get_holidays('FR', 2024)