country | holidays.rest | Documentation

curl https://api.holidays.rest/v1/country/US \
     -H "Authorization: Bearer <token>"

{
  "name": "United States of America",
  "long_name": "The United States of America",
  "region": "Americas",
  "subregion": "Northern America",
  "world_region": "AMER",
  "alpha2": "US",
  "subdivisions": [
    {
      "name": "Alaska",
      "alpha2": "AK"
    },
    {
      "name": "Alabama",
      "alpha2": "AL"
    },
    {
      "name": "Arkansas",
      "alpha2": "AR"
    },
    {
      "name": "American Samoa",
      "alpha2": "AS"
    },
    {
      "name": "Arizona",
      "alpha2": "AZ"
    },
    {
      "name": "California",
      "alpha2": "CA"
    },
    {
      "name": "Colorado",
      "alpha2": "CO"
    },
    {
      "name": "Connecticut",
      "alpha2": "CT"
    },
    {
      "name": "District of Columbia",
      "alpha2": "DC"
    },
    {
      "name": "Delaware",
      "alpha2": "DE"
    },
    {
      "name": "Florida",
      "alpha2": "FL"
    },
    {
      "name": "Georgia",
      "alpha2": "GA"
    },
    {
      "name": "Guam",
      "alpha2": "GU"
    },
    {
      "name": "Hawaii",
      "alpha2": "HI"
    },
    {
      "name": "Iowa",
      "alpha2": "IA"
    },
    {
      "name": "Idaho",
      "alpha2": "ID"
    },
    {
      "name": "Illinois",
      "alpha2": "IL"
    },
    {
      "name": "Indiana",
      "alpha2": "IN"
    },
    {
      "name": "Kansas",
      "alpha2": "KS"
    },
    {
      "name": "Kentucky",
      "alpha2": "KY"
    },
    {
      "name": "Louisiana",
      "alpha2": "LA"
    },
    {
      "name": "Massachusetts",
      "alpha2": "MA"
    },
    {
      "name": "Maryland",
      "alpha2": "MD"
    },
    {
      "name": "Maine",
      "alpha2": "ME"
    },
    {
      "name": "Michigan",
      "alpha2": "MI"
    },
    {
      "name": "Minnesota",
      "alpha2": "MN"
    },
    {
      "name": "Missouri",
      "alpha2": "MO"
    },
    {
      "name": "Northern Mariana Islands",
      "alpha2": "MP"
    },
    {
      "name": "Mississippi",
      "alpha2": "MS"
    },
    {
      "name": "Montana",
      "alpha2": "MT"
    },
    {
      "name": "North Carolina",
      "alpha2": "NC"
    },
    {
      "name": "North Dakota",
      "alpha2": "ND"
    },
    {
      "name": "Nebraska",
      "alpha2": "NE"
    },
    {
      "name": "New Hampshire",
      "alpha2": "NH"
    },
    {
      "name": "New Jersey",
      "alpha2": "NJ"
    },
    {
      "name": "New Mexico",
      "alpha2": "NM"
    },
    {
      "name": "Nevada",
      "alpha2": "NV"
    },
    {
      "name": "New York",
      "alpha2": "NY"
    },
    {
      "name": "Ohio",
      "alpha2": "OH"
    },
    {
      "name": "Oklahoma",
      "alpha2": "OK"
    },
    {
      "name": "Oregon",
      "alpha2": "OR"
    },
    {
      "name": "Pennsylvania",
      "alpha2": "PA"
    },
    {
      "name": "Puerto Rico",
      "alpha2": "PR"
    },
    {
      "name": "Rhode Island",
      "alpha2": "RI"
    },
    {
      "name": "South Carolina",
      "alpha2": "SC"
    },
    {
      "name": "South Dakota",
      "alpha2": "SD"
    },
    {
      "name": "Tennessee",
      "alpha2": "TN"
    },
    {
      "name": "Texas",
      "alpha2": "TX"
    },
    {
      "name": "United States Minor Outlying Islands",
      "alpha2": "UM"
    },
    {
      "name": "Utah",
      "alpha2": "UT"
    },
    {
      "name": "Virginia",
      "alpha2": "VA"
    },
    {
      "name": "Virgin Islands, U.S.",
      "alpha2": "VI"
    },
    {
      "name": "Vermont",
      "alpha2": "VT"
    },
    {
      "name": "Washington",
      "alpha2": "WA"
    },
    {
      "name": "Wisconsin",
      "alpha2": "WI"
    },
    {
      "name": "West Virginia",
      "alpha2": "WV"
    },
    {
      "name": "Wyoming",
      "alpha2": "WY"
    }
  ]
}

curl https://api.holidays.rest/v1/country/US \
     -H "Authorization: Bearer <token>"

{
  "name": "United States of America",
  "long_name": "The United States of America",
  "region": "Americas",
  "subregion": "Northern America",
  "world_region": "AMER",
  "alpha2": "US",
  "subdivisions": [
    {
      "name": "Alaska",
      "alpha2": "AK"
    },
    {
      "name": "Alabama",
      "alpha2": "AL"
    },
    {
      "name": "Arkansas",
      "alpha2": "AR"
    },
    {
      "name": "American Samoa",
      "alpha2": "AS"
    },
    {
      "name": "Arizona",
      "alpha2": "AZ"
    },
    {
      "name": "California",
      "alpha2": "CA"
    },
    {
      "name": "Colorado",
      "alpha2": "CO"
    },
    {
      "name": "Connecticut",
      "alpha2": "CT"
    },
    {
      "name": "District of Columbia",
      "alpha2": "DC"
    },
    {
      "name": "Delaware",
      "alpha2": "DE"
    },
    {
      "name": "Florida",
      "alpha2": "FL"
    },
    {
      "name": "Georgia",
      "alpha2": "GA"
    },
    {
      "name": "Guam",
      "alpha2": "GU"
    },
    {
      "name": "Hawaii",
      "alpha2": "HI"
    },
    {
      "name": "Iowa",
      "alpha2": "IA"
    },
    {
      "name": "Idaho",
      "alpha2": "ID"
    },
    {
      "name": "Illinois",
      "alpha2": "IL"
    },
    {
      "name": "Indiana",
      "alpha2": "IN"
    },
    {
      "name": "Kansas",
      "alpha2": "KS"
    },
    {
      "name": "Kentucky",
      "alpha2": "KY"
    },
    {
      "name": "Louisiana",
      "alpha2": "LA"
    },
    {
      "name": "Massachusetts",
      "alpha2": "MA"
    },
    {
      "name": "Maryland",
      "alpha2": "MD"
    },
    {
      "name": "Maine",
      "alpha2": "ME"
    },
    {
      "name": "Michigan",
      "alpha2": "MI"
    },
    {
      "name": "Minnesota",
      "alpha2": "MN"
    },
    {
      "name": "Missouri",
      "alpha2": "MO"
    },
    {
      "name": "Northern Mariana Islands",
      "alpha2": "MP"
    },
    {
      "name": "Mississippi",
      "alpha2": "MS"
    },
    {
      "name": "Montana",
      "alpha2": "MT"
    },
    {
      "name": "North Carolina",
      "alpha2": "NC"
    },
    {
      "name": "North Dakota",
      "alpha2": "ND"
    },
    {
      "name": "Nebraska",
      "alpha2": "NE"
    },
    {
      "name": "New Hampshire",
      "alpha2": "NH"
    },
    {
      "name": "New Jersey",
      "alpha2": "NJ"
    },
    {
      "name": "New Mexico",
      "alpha2": "NM"
    },
    {
      "name": "Nevada",
      "alpha2": "NV"
    },
    {
      "name": "New York",
      "alpha2": "NY"
    },
    {
      "name": "Ohio",
      "alpha2": "OH"
    },
    {
      "name": "Oklahoma",
      "alpha2": "OK"
    },
    {
      "name": "Oregon",
      "alpha2": "OR"
    },
    {
      "name": "Pennsylvania",
      "alpha2": "PA"
    },
    {
      "name": "Puerto Rico",
      "alpha2": "PR"
    },
    {
      "name": "Rhode Island",
      "alpha2": "RI"
    },
    {
      "name": "South Carolina",
      "alpha2": "SC"
    },
    {
      "name": "South Dakota",
      "alpha2": "SD"
    },
    {
      "name": "Tennessee",
      "alpha2": "TN"
    },
    {
      "name": "Texas",
      "alpha2": "TX"
    },
    {
      "name": "United States Minor Outlying Islands",
      "alpha2": "UM"
    },
    {
      "name": "Utah",
      "alpha2": "UT"
    },
    {
      "name": "Virginia",
      "alpha2": "VA"
    },
    {
      "name": "Virgin Islands, U.S.",
      "alpha2": "VI"
    },
    {
      "name": "Vermont",
      "alpha2": "VT"
    },
    {
      "name": "Washington",
      "alpha2": "WA"
    },
    {
      "name": "Wisconsin",
      "alpha2": "WI"
    },
    {
      "name": "West Virginia",
      "alpha2": "WV"
    },
    {
      "name": "Wyoming",
      "alpha2": "WY"
    }
  ]
}

This endpoint retrieves a specific country, including its subdivisions. You can use the alpha2 code to retrieve public holidays of a region when calling the holidays endpoint.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

countryIDstringRequired

(Required) Country code in ISO-3166 alpha-2 format

Response headers

:statusstring

nelstring

etagstring

access-control-allow-originstring

agestring

expiresstring

cache-controlstring

cf-cache-statusstring

report-tostring

cf-raystring

alt-svcstring

Response

namestring

long_namestring

regionstring

subregionstring

world_regionstring

alpha2string

subdivisionslist of objects

Errors

401

Unauthorized Error

$	curl https://api.holidays.rest/v1/country/US \
>	-H "Authorization: Bearer <token>"

1	{
2	"name": "United States of America",
3	"long_name": "The United States of America",
4	"region": "Americas",
5	"subregion": "Northern America",
6	"world_region": "AMER",
7	"alpha2": "US",
8	"subdivisions": [
9	{
10	"name": "Alaska",
11	"alpha2": "AK"
12	},
13	{
14	"name": "Alabama",
15	"alpha2": "AL"
16	},
17	{
18	"name": "Arkansas",
19	"alpha2": "AR"
20	},
21	{
22	"name": "American Samoa",
23	"alpha2": "AS"
24	},
25	{
26	"name": "Arizona",
27	"alpha2": "AZ"
28	},
29	{
30	"name": "California",
31	"alpha2": "CA"
32	},
33	{
34	"name": "Colorado",
35	"alpha2": "CO"
36	},
37	{
38	"name": "Connecticut",
39	"alpha2": "CT"
40	},
41	{
42	"name": "District of Columbia",
43	"alpha2": "DC"
44	},
45	{
46	"name": "Delaware",
47	"alpha2": "DE"
48	},
49	{
50	"name": "Florida",
51	"alpha2": "FL"
52	},
53	{
54	"name": "Georgia",
55	"alpha2": "GA"
56	},
57	{
58	"name": "Guam",
59	"alpha2": "GU"
60	},
61	{
62	"name": "Hawaii",
63	"alpha2": "HI"
64	},
65	{
66	"name": "Iowa",
67	"alpha2": "IA"
68	},
69	{
70	"name": "Idaho",
71	"alpha2": "ID"
72	},
73	{
74	"name": "Illinois",
75	"alpha2": "IL"
76	},
77	{
78	"name": "Indiana",
79	"alpha2": "IN"
80	},
81	{
82	"name": "Kansas",
83	"alpha2": "KS"
84	},
85	{
86	"name": "Kentucky",
87	"alpha2": "KY"
88	},
89	{
90	"name": "Louisiana",
91	"alpha2": "LA"
92	},
93	{
94	"name": "Massachusetts",
95	"alpha2": "MA"
96	},
97	{
98	"name": "Maryland",
99	"alpha2": "MD"
100	},
101	{
102	"name": "Maine",
103	"alpha2": "ME"
104	},
105	{
106	"name": "Michigan",
107	"alpha2": "MI"
108	},
109	{
110	"name": "Minnesota",
111	"alpha2": "MN"
112	},
113	{
114	"name": "Missouri",
115	"alpha2": "MO"
116	},
117	{
118	"name": "Northern Mariana Islands",
119	"alpha2": "MP"
120	},
121	{
122	"name": "Mississippi",
123	"alpha2": "MS"
124	},
125	{
126	"name": "Montana",
127	"alpha2": "MT"
128	},
129	{
130	"name": "North Carolina",
131	"alpha2": "NC"
132	},
133	{
134	"name": "North Dakota",
135	"alpha2": "ND"
136	},
137	{
138	"name": "Nebraska",
139	"alpha2": "NE"
140	},
141	{
142	"name": "New Hampshire",
143	"alpha2": "NH"
144	},
145	{
146	"name": "New Jersey",
147	"alpha2": "NJ"
148	},
149	{
150	"name": "New Mexico",
151	"alpha2": "NM"
152	},
153	{
154	"name": "Nevada",
155	"alpha2": "NV"
156	},
157	{
158	"name": "New York",
159	"alpha2": "NY"
160	},
161	{
162	"name": "Ohio",
163	"alpha2": "OH"
164	},
165	{
166	"name": "Oklahoma",
167	"alpha2": "OK"
168	},
169	{
170	"name": "Oregon",
171	"alpha2": "OR"
172	},
173	{
174	"name": "Pennsylvania",
175	"alpha2": "PA"
176	},
177	{
178	"name": "Puerto Rico",
179	"alpha2": "PR"
180	},
181	{
182	"name": "Rhode Island",
183	"alpha2": "RI"
184	},
185	{
186	"name": "South Carolina",
187	"alpha2": "SC"
188	},
189	{
190	"name": "South Dakota",
191	"alpha2": "SD"
192	},
193	{
194	"name": "Tennessee",
195	"alpha2": "TN"
196	},
197	{
198	"name": "Texas",
199	"alpha2": "TX"
200	},
201	{
202	"name": "United States Minor Outlying Islands",
203	"alpha2": "UM"
204	},
205	{
206	"name": "Utah",
207	"alpha2": "UT"
208	},
209	{
210	"name": "Virginia",
211	"alpha2": "VA"
212	},
213	{
214	"name": "Virgin Islands, U.S.",
215	"alpha2": "VI"
216	},
217	{
218	"name": "Vermont",
219	"alpha2": "VT"
220	},
221	{
222	"name": "Washington",
223	"alpha2": "WA"
224	},
225	{
226	"name": "Wisconsin",
227	"alpha2": "WI"
228	},
229	{
230	"name": "West Virginia",
231	"alpha2": "WV"
232	},
233	{
234	"name": "Wyoming",
235	"alpha2": "WY"
236	}
237	]
238	}