🎉 Public Holiday API

The Public Holiday API offers an easy way to query holidays for over 100 countries, including options to check for long weekends. Designed for flexibility, it features an endpoint for IoT devices to verify if today is a holiday.

🌟 Benefits

• ✅ Access to 100 Countries: Comprehensive coverage of public holidays worldwide.
• ✅ Always Up-to-Date Information: Enjoy reliable and current data for all holidays.
• ✅ Simple Implementation: Easy to integrate into your software with straightforward endpoints.

🚀 Simple Request

Easily get public holidays for a specified year and country with a simple request.

🌍 Join Us Today!

Start using the Public Holiday API and enhance your applications with accurate holiday data. Make planning easier for your users and improve their experience!

Input

A full explanation of an input example in JSON.

1{
2  "year": "2023",
3  "countryCode": "US"
4}

Output sample

The results will be wrapped into a dataset which you can always find in the Storage tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

1[
2    {
3        "date": "2024-01-01",
4        "localName": "New Year's Day",
5        "name": "New Year's Day",
6        "countryCode": "US",
7        "fixed": false,
8        "global": true,
9        "counties": null,
10        "launchYear": null,
11        "types": [
12            "Public"
13        ]
14    },
15    {
16        "date": "2024-01-15",
17        "localName": "Martin Luther King, Jr. Day",
18        "name": "Martin Luther King, Jr. Day",
19        "countryCode": "US",
20        "fixed": false,
21        "global": true,
22        "counties": null,
23        "launchYear": null,
24        "types": [
25            "Public"
26        ]
27    },
28    {
29        "date": "2024-02-19",
30        "localName": "Washington's Birthday",
31        "name": "Presidents Day",
32        "countryCode": "US",
33        "fixed": false,
34        "global": true,
35        "counties": null,
36        "launchYear": null,
37        "types": [
38            "Public"
39        ]
40    }
41    ...
42]