Back to exploreutil

Holidays

Find the holidays observed in a particular country

Countries

Get the list of countries that are supported by this API

Price: Free

Request Payload

Response

countriesarray

Request

Response

1{
2    "countries": [
3        {
4            "code": "AR",
5            "name": "Argentina"
6        },
7        {
8            "code": "AU",
9            "name": "Australia"
10        },
11        {
12            "code": "BR",
13            "name": "Brazil"
14        },
15        {
16            "code": "CA",
17            "name": "Canada"
18        },
19        {
20            "code": "CH",
21            "name": "Switzerland"
22        },
23        {
24            "code": "CL",
25            "name": "Chile"
26        },
27        {
28            "code": "CN",
29            "name": "China"
30        },
31        {
32            "code": "CO",
33            "name": "Colombia"
34        },
35        {
36            "code": "DE",
37            "name": "Germany"
38        },
39        {
40            "code": "DK",
41            "name": "Denmark"
42        },
43        {
44            "code": "ES",
45            "name": "Spain"
46        },
47        {
48            "code": "FR",
49            "name": "France"
50        },
51        {
52            "code": "GB",
53            "name": "United Kingdom"
54        },
55        {
56            "code": "HU",
57            "name": "Hungary"
58        },
59        {
60            "code": "IT",
61            "name": "Italy"
62        },
63        {
64            "code": "JP",
65            "name": "Japan"
66        },
67        {
68            "code": "KR",
69            "name": "South Korea"
70        },
71        {
72            "code": "MX",
73            "name": "Mexico"
74        },
75        {
76            "code": "SG",
77            "name": "Singapore"
78        },
79        {
80            "code": "US",
81            "name": "United States"
82        },
83        {
84            "code": "ZA",
85            "name": "South Africa"
86        }
87    ]
88}

List

List the holiday dates for a given country and year

Price: Free

Request Payload

countryCodestring

The 2 letter country code (as defined in ISO 3166-1 alpha-2)

yearnumber

The year to list holidays for

Response

holidaysarray

Request

Response

1{
2    "holidays": [
3        {
4            "date": "2022-01-01",
5            "name": "New Year's Day",
6            "local_name": "New Year's Day",
7            "country_code": "GB",
8            "regions": [
9                "GB-NIR"
10            ],
11            "types": [
12                "Public"
13            ]
14        },
15        {
16            "date": "2022-01-03",
17            "name": "New Year's Day",
18            "local_name": "New Year's Day",
19            "country_code": "GB",
20            "regions": [
21                "GB-ENG",
22                "GB-WLS"
23            ],
24            "types": [
25                "Public"
26            ]
27        },
28        {
29            "date": "2022-01-03",
30            "name": "New Year's Day",
31            "local_name": "New Year's Day",
32            "country_code": "GB",
33            "regions": [
34                "GB-SCT"
35            ],
36            "types": [
37                "Public"
38            ]
39        },
40        {
41            "date": "2022-01-04",
42            "name": "New Year's Day",
43            "local_name": "New Year's Day",
44            "country_code": "GB",
45            "regions": [
46                "GB-SCT"
47            ],
48            "types": [
49                "Public"
50            ]
51        },
52        {
53            "date": "2022-03-17",
54            "name": "Saint Patrick's Day",
55            "local_name": "Saint Patrick's Day",
56            "country_code": "GB",
57            "regions": [
58                "GB-NIR"
59            ],
60            "types": [
61                "Public"
62            ]
63        },
64        {
65            "date": "2022-04-15",
66            "name": "Good Friday",
67            "local_name": "Good Friday",
68            "country_code": "GB",
69            "regions": [],
70            "types": [
71                "Public"
72            ]
73        },
74        {
75            "date": "2022-04-18",
76            "name": "Easter Monday",
77            "local_name": "Easter Monday",
78            "country_code": "GB",
79            "regions": [
80                "GB-ENG",
81                "GB-WLS",
82                "GB-NIR"
83            ],
84            "types": [
85                "Public"
86            ]
87        },
88        {
89            "date": "2022-05-02",
90            "name": "Early May Bank Holiday",
91            "local_name": "Early May Bank Holiday",
92            "country_code": "GB",
93            "regions": [],
94            "types": [
95                "Public"
96            ]
97        },
98        {
99            "date": "2022-06-02",
100            "name": "Spring Bank Holiday",
101            "local_name": "Spring Bank Holiday",
102            "country_code": "GB",
103            "regions": [],
104            "types": [
105                "Public"
106            ]
107        },
108        {
109            "date": "2022-06-03",
110            "name": "Queen’s Platinum Jubilee",
111            "local_name": "Queen’s Platinum Jubilee",
112            "country_code": "GB",
113            "regions": [],
114            "types": [
115                "Public"
116            ]
117        },
118        {
119            "date": "2022-07-12",
120            "name": "Battle of the Boyne",
121            "local_name": "Battle of the Boyne",
122            "country_code": "GB",
123            "regions": [
124                "GB-NIR"
125            ],
126            "types": [
127                "Public"
128            ]
129        },
130        {
131            "date": "2022-08-01",
132            "name": "Summer Bank Holiday",
133            "local_name": "Summer Bank Holiday",
134            "country_code": "GB",
135            "regions": [
136                "GB-SCT"
137            ],
138            "types": [
139                "Public"
140            ]
141        },
142        {
143            "date": "2022-08-29",
144            "name": "Summer Bank Holiday",
145            "local_name": "Summer Bank Holiday",
146            "country_code": "GB",
147            "regions": [
148                "GB-ENG",
149                "GB-WLS",
150                "GB-NIR"
151            ],
152            "types": [
153                "Public"
154            ]
155        },
156        {
157            "date": "2022-11-30",
158            "name": "Saint Andrew's Day",
159            "local_name": "Saint Andrew's Day",
160            "country_code": "GB",
161            "regions": [
162                "GB-SCT"
163            ],
164            "types": [
165                "Public"
166            ]
167        },
168        {
169            "date": "2022-12-26",
170            "name": "St. Stephen's Day",
171            "local_name": "Boxing Day",
172            "country_code": "GB",
173            "regions": [],
174            "types": [
175                "Public"
176            ]
177        },
178        {
179            "date": "2022-12-27",
180            "name": "Christmas Day",
181            "local_name": "Christmas Day",
182            "country_code": "GB",
183            "regions": [],
184            "types": [
185                "Public"
186            ]
187        }
188    ]
189}