Public holidays · Observances · Calendars
Holiday API
Plan around the holidays.
Check public holidays before you promise a delivery date, confirm a booking or fill a calendar.
Start free. Holiday is included on every plan.
Try it
One date. A whole calendar.
Holiday data.
Ready for your app.
Check a date or list the holidays in a month or year. One request. Complete JSON.
Check a date before you promise it.
Get the holiday name, type and regional scope in one request.
Request
curl "https://api.parseapi.com/holiday/US/2026-12-25" \
-H "X-API-Key: YOUR_API_KEY"Example response
Native names, empty results and more requests
Every holiday on one date.
Day filters return an array of matching records.
Request
curl "https://api.parseapi.com/holiday/US?year=2026&month=12&day=25" \
-H "X-API-Key: YOUR_API_KEY"Example response
Observed holidays
Use the
observed date.
A weekend holiday can be observed on another date. Get the designated date for the calendar you use, with the replacement-day flag included.
See the JSONFriday
3
Saturday
4
Sunday
5
Observed Friday, July 3.
substitute: true
Types and regional scope
The right dates.
For the right calendar.
Public holidays help you plan a schedule. Observances belong in reminders and campaigns. Regional codes show where a date applies; native names keep the local context.
Explore dates and regions- Christmas Daypublic
- Dec 25, 2026
- A public holiday in the US federal calendar.
- Halloweenobservance
- Oct 31, 2026
- A cultural observance for calendars and campaigns.
Use the type field to distinguish public holidays from observances. Workplace opening hours follow your own rules.
Working dates
Count the working days.
Find the next date.
Turn public holidays into a schedule. Choose your weekend days, include your closures and calculate the date after a number of working days.
- Count a window
- Count working dates between two included endpoints using the calendar and policy you select.
- Find a date
- Move forward or back by working days. Ask for the daily explanation when you need it.
Try working-day calculations
Coverage and review
Choose a country.
Check the year.
Available years and regional scope vary by calendar. Check the dates your product needs before building on them.
An unavailable year returns an error. Dates awaiting confirmation stay explicit.
Check a calendar
Calendar coverageUnited States · 2027
AvailableFederal holidays by default. State calendars are also available.
Details
Federal calendar scope: Observed federal holidays. State, local and employer-specific calendars are outside this scope.
12 holiday records Reviewed 10 Oct 2026
State calendars for 2027
- Alabama · public holidays
AL - Alaska · public holidays
AK - Arizona · public holidays
AZ - Arkansas · public holidays
AR - California · legal public holidays
CA - Colorado · public holidays
CO - Connecticut · public holidays
CT - Delaware · public holidays
DE - Florida · state branches and agencies
FL - Georgia · Capitol and state agencies
GA - Hawaii · public holidays
HI - Idaho · public holidays
ID - Illinois · state offices
IL - Indiana · public holidays
IN - Iowa · public holidays
IA - Kansas · public holidays
KS - Kentucky · public holidays
KY - Louisiana · public holidays
LA - Maine · public holidays
ME - Maryland · public holidays
MD - Massachusetts · public offices
MA - Michigan · public holidays
MI - Minnesota · public holidays
MN - Mississippi · public holidays
MS - Missouri · public holidays
MO - Montana · public holidays
MT - Nebraska · public holidays
NE - Nevada · public holidays
NV - New Hampshire · public holidays
NH - New Jersey · public holidays
NJ - New Mexico · public holidays
NM - New York · legal public holidays
NY - North Carolina · public holidays
NC - North Dakota · public holidays
ND - Ohio · public holidays
OH - Oklahoma · state-government agencies
OK - Oregon · public holidays
OR - Pennsylvania · Commonwealth holidays
PA - Rhode Island · public holidays
RI - South Carolina · state employees
SC - South Dakota · public holidays
SD - Tennessee · public holidays
TN - Texas · state public holidays
TX - Utah · public holidays
UT - Vermont · public holidays
VT - Virginia · public holidays
VA - Washington · general government
WA - West Virginia · public holidays
WV - Wisconsin · public holidays
WI - Wyoming · public holidays
WY
Select a state with region. The calendar response shows its public holiday scope and any dates awaiting confirmation.
GET /holiday/US/calendar?year=2027®ion=ALDownload this calendar
Save recorded public dates as JSON, CSV or an all-day calendar. New downloads use the current dates and declared scope.
View all 160 countries and territories
Coverage
Published holiday dates for 160 countries and territories. Years and regional coverage vary.
- Aland Islands
- Albania
- Andorra
- Angola
- Anguilla
- Argentina
- Armenia
- Aruba
- Australia
- Austria
- Azerbaijan
- Bahamas
- Bahrain
- Bangladesh
- Barbados
- Belarus
- Belgium
- Belize
- Benin
- Bermuda
- Bhutan
- Bolivia
- Bonaire, Saint Eustatius and Saba
- Botswana
- Brazil
- British Virgin Islands
- Brunei
- Bulgaria
- Cambodia
- Canada
- Cayman Islands
- Chile
- China
- Christmas Island
- Cocos (Keeling) Islands
- Colombia
- Cook Islands
- Costa Rica
- Croatia
- Czechia
- Denmark
- Dominica
- Dominican Republic
- East Timor
- Ecuador
- Egypt
- El Salvador
- Estonia
- Falkland Islands
- Fiji
- Finland
- France
- French Guiana
- French Polynesia
- Georgia
- Germany
- Ghana
- Gibraltar
- Greece
- Guadeloupe
- Guam
- Guatemala
- Guernsey
- Honduras
- Hong Kong
- Hungary
- Iceland
- India
- Indonesia
- Iraq
- Ireland
- Isle of Man
- Italy
- Jamaica
- Japan
- Jersey
- Jordan
- Kazakhstan
- Kenya
- Kosovo
- Kyrgyzstan
- Laos
- Latvia
- Lebanon
- Liechtenstein
- Lithuania
- Luxembourg
- Macao
- Malaysia
- Maldives
- Malta
- Marshall Islands
- Martinique
- Mauritius
- Mayotte
- Mexico
- Monaco
- Mongolia
- Montenegro
- Namibia
- Nauru
- Netherlands
- New Caledonia
- New Zealand
- Nicaragua
- Nigeria
- Norfolk Island
- North Macedonia
- Northern Mariana Islands
- Norway
- Oman
- Pakistan
- Panama
- Papua New Guinea
- Paraguay
- Peru
- Philippines
- Poland
- Portugal
- Qatar
- Republic of the Congo
- Reunion
- Romania
- Russia
- Saint Barthelemy
- Saint Helena
- Saint Lucia
- Saint Martin
- Saint Pierre and Miquelon
- Saint Vincent and the Grenadines
- Samoa
- San Marino
- Saudi Arabia
- Serbia
- Seychelles
- Singapore
- Slovakia
- Slovenia
- Solomon Islands
- South Africa
- South Korea
- Spain
- Sri Lanka
- Sweden
- Switzerland
- Taiwan
- Thailand
- Tonga
- Turkey
- Turkmenistan
- Turks and Caicos Islands
- United Arab Emirates
- United Kingdom
- United States
- Uruguay
- Uzbekistan
- Vanuatu
- Venezuela
- Vietnam
- Zimbabwe
One integration
A small request.
A useful answer.
Use Holiday over HTTP or through an SDK. The same country codes, dates and holiday fields carry from your first lookup into your app.
Response fields and their meaning
Response fields
- countrystring
- ISO2 country code
- yearinteger
- Year returned
- monthinteger
- Selected month, present on month and day collections
- dayinteger
- Selected day of month, present on day collections
- holidaysarray
- Every matching holiday and observance, including multiple names on one date. Empty array for a covered period with no matches
- holidays[].datestring
- Date, YYYY-MM-DD
- holidays[].namestring
- Official name, English or the official translation (France stays French)
- holidays[].name_localstring or null
- Native form when it differs (Japan kanji, Hong Kong and Taiwan Chinese), null otherwise
- holidays[].typestring
- public for an officially designated holiday, observance for cultural dates (Halloween, Black Friday)
- holidays[].regionsarray or null
- Subdivision codes where this record applies (GB: ENG, WLS, SCT, NIR). Null means country-wide within the calendar’s declared scope; it does not establish workplace closure
- holidays[].substituteboolean
- Source calendar replacement or in-lieu flag. It does not establish the original occasion; reviewed actual/observed relationships are available in calendar Deep when known
- editionstring
- Only with a requested archive pin: the exact public calendar edition. Archived rows do not establish current live availability
Before you build.
Which countries and years are supported?
Holiday covers 160 countries and territories. Available years and regional scope vary by calendar. An unavailable year returns 404 with the available range. Check the calendar you need before building your schedule.
How do I check one date or list a period?
A full date path returns a holiday object or null within a covered calendar. A year or month returns a holidays array. Use year, month and day query filters for all matches on one date.
What is an observed holiday?
A holiday can have a separate observed date under that calendar’s rules. The substitute field preserves the source calendar’s replacement-day flag; it does not by itself identify the original occasion.
How do regional holidays work?
The regions field lists the subdivision codes where a holiday applies. A null regions field means nationwide within that calendar's declared scope. Federal, government-office and employer calendars can have different rules.
Does a holiday mean everyone has the day off?
Public holiday status, cultural observances and workplace closures are different things. Use the type and regional scope, then apply the working week and exceptions for the schedule you are building.
How are Holiday requests priced?
Holiday is included on every plan. Your API request allowance is shared across ParseAPI products. Choose the capacity your app needs.
How do partial calendars work?
The calendar resource shows confirmed dates and unresolved qualifications. A partial calendar can answer a confirmed holiday lookup. A complete list or an uncertain date answer returns 503 rather than guessing that an unlisted date is working.
Can one request cross into the next year?
The range request accepts inclusive from and to dates, spanning up to 731 dates. Public holidays and observances are separate types. Every reached year must be available; missing years return an error. Use HTTP on API 2.0.0.
What is included in the working-day calculation?
Choose an inclusive date range, region and weekend policy. Add explicit working dates or extra closures. Optional official work profiles use their declared scope. Calendar and profile editions can both be saved with the request. Use HTTP on API 2.0.0.
Can planning dates fill an unpublished calendar?
Planning dates show reviewed announcements and their confirmation status. They remain separate from usable calendars. A partial planning calendar cannot establish that an unlisted date is working.
Browse dates in the public holidays tool, or use the business days calculator.