NonWorkingDays
Search

Free, no key

Holidays API

JSON and calendar feeds for 54 countries. Cache responses and link back to nonworkingdays.app.

Holidays of a country and year

GET /api/v1/holidays/{country code}/{year}. Optional: public=1 (public holidays only), region=BY (nationwide plus that region).

curl https://nonworkingdays.app/api/v1/holidays/DE/2027?public=1&region=BY

Each holiday has the date, English and local name, types (P public, B bank, A government offices, O optional, H half day, R religious, U observance), whether it is nationwide, its regions, and flags for estimated and substitute dates. The response also carries the source, its version and licence, and the country's verification status.

Countries

GET /api/v1/countries lists the countries covered, their years and verification status.

curl https://nonworkingdays.app/api/v1/countries

Calendar feeds

Subscribe in Google Calendar, Apple Calendar or Outlook with a URL like this one (add region=BY for a region):

https://nonworkingdays.app/api/ics/DE/2027

Printable sheets: /api/export/DE/2027?fmt=pdf (or png), a white A4 page with all twelve months.