Public Holidays API Blog
Practical guides for developers working with public holiday data. Ready to build? Read the API documentation.
Public holidays by country 2026 & 2027Every holiday date, weekday and long weekend for 195 countries.
How to Calculate Business Days Excluding Public Holidays
To calculate business days between two dates, count every day in the range that is not a weekend and not a public holiday in the relevant country. Weekends are simple to detect from the calendar; public holidays differ by country and change every year, so they should come from a data source instead of being…
How to Check if a Date Is a Public Holiday with an API
To check whether a date is a public holiday, send one request to a public holidays API with a country code and a date. If the response contains holidays, the date is a public holiday in that country; if it is empty, it is a regular day. With the HolidaysMap API that is a single GET request to /api/v1/holidays. A free…
Public Holidays JSON: Format, Fields and How to Use It
A public holidays API returns a JSON object with a list of holidays, where each holiday has a name, a date, a flag that says whether it is a public holiday, and the country it belongs to. This page explains the response of the HolidaysMap API field by field and shows how to read it safely. Always use ispublic to…