Back to exploreutil

Holidays

Find the holidays observed in a particular country

Introduction

List holidays observed in a country. Holidays may be at the country or region level.

Holiday types are:

  • Public - public holiday
  • Bank - banks and offices are closed
  • School - schools are closed
  • Authorities - Government or other authorities are closed
  • Optional - A day where a majority of people take the day off
  • Observance - Optional day off, typically unpaid

Powered by Nager.Date

FeaturesFull documentation

EndpointDescriptionPricing (per request)
CountriesGet the list of countries that are supported by this APIFree
ListList the holiday dates for a given country and yearFree

Example

Please see an example of how to get started with the holidays api.

For a more detailed view please see the API page

Countries 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}