Holidays API

Retrieve religious, non-public and public holidays for 200+ countries worldwide and for any specific year
    ? api_key = YOUR_UNIQUE_API_KEY
    & country = SG

    "name": "New Year's Day",
    "name_local": "",
    "language": "",
    "description": "",
    "country": "SG",
    "location": "Singapore",
    "type": "National",
    "date": "01/01/2023",
    "date_year": "2023",
    "date_day": "01",
    "week_day": "Wednesday"

API benefits

190+ countries and 3,500+ regions
>100 years of historical and future holidays
Updated and
verified weekly
All holidays included, like regional and religious
The world’s best engineering teams run on Abstract
4.8 from 1,863 votes

Built for developers
by developers

Built for global coverage
A global architecture that ensures fast, reliable, and redundant service with industry-standard data sovereignty and privacy.
Built for scale
Whether you have 10 or 10,000 requests per second, we’re ready for you.
Built for blazing speed
Milliseconds matter. We obsess about every single one of them in a response.
Built for reliable uptime
Every minute of uptime counts. That’s why public companies, financial institutions, airlines, governments, and more trust us in production.

Get into production
this afternoon

Customer-obsessed technical support
Everything you need to get live and stay that way. Fast, responsive, and friendly support from developers.  24/7 via email, chat, and phone.
Integrate with your stack
Abstract integrates with the tools you already use, from cloud and analytics platforms to low code tools to ERPs, CRMs, and more.
World-class docs and SDKs
We obsess over “time to first production request”. That’s why we provide a ton of code samples, libraries, and SDKs to get you started quickly.
Ready for the enterprise
Compliance is at our core. We’re committed to industry-standard security and privacy frameworks, like SOC 2 and GDPR.
Type II
uptime SLA
For more information check our

The latest and most accurate
public and local holiday data from around the world

190+ countries and 3,500 regions covered
Abstract's database of public holidays has been global since the beginning, so it covers everywhere from Argentina to Zimbabwe, from Alabama in the US to Zhejiang in China.
Data on historical and future holidays
The holiday dataset is also very extensive in time, covering historical and future holidays ranging from 1 AD to past 2050. Simplify specify the year you need.
Holiday data updated and verified monthly
Countries alter holidays from time to time, whether it's changing the date, name, or adding new ones. So Abstract has a robust process for ensuring the data is always accurate.
Non-public, religious holidays included
For some countries our dataset also includes non public holidays, such as religious holidays, which may not be government-level holidays but which may still be observed by the population.
Protected by bank-level security
Security is also a top concern of ours, so all data that is sent to Abstract's Holidays API and processed there is secured via 256-bit SSL encryption (HTTPS). Stay GDPR compliant by using our GDPR cookie banner creator.
Get your free
Holidays API
key now
4.8 from 1,863 votes
See why the best developers build on Abstract
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
No credit card required
Holidays API
that works where you do

Simple and transparent pricing


  • 1,000 requests
  • 1 request / second


99/ month
  • 60,000
    requests / year
  • 3
    requests / second


A plan based on your specific
  • A plan based on your specific needs
  • 99.99% uptime SLA
  • SSO/SAML login
  • 24/7 support via email, chat and phone
  • Technical onboarding support, account manager

The best build
on Abstract

Wow, I wish we had found the Holiday API sooner! We basically stopped supporting certain really powerful customization jobs because we couldn't accurately set holidays. We had been looking for something like for a while and were so happy when we got set up with Abstract's Holiday API.
Daniel Radin, Okta
Enterprise ready
Abstract comes with security, compliance, and reliability built into the core. That’s why the Fortune 500, governments, and businesses in critical industries like financial services, healthcare, and airlines trust us.
99.99% uptime SLA
SSO/AML login
24/7 support via email, chat, and phone
Technical onboarding support
Dedicated account manager

Public Holidays
API Changelog

Addressed User feedback on holiday data retrieval for specific countries in Asia Pacific

May 20, 2024

Expanded data to support marketing-related campaigns by adding insights to public holidays

April 8, 2024

Added holiday updates for some countries in Southeast Asia

March 25, 2024

FAQ about Abstract's
Holiday API

What is the Holiday API?

The Holiday API is a simple to use API that provides access to a list of past and future public holidays for every country in the world. The dates, names, and other details of holidays do change, and the Abstract Holiday API makes it easy to stay on top of these changes without investing much time or effort.

What are some use cases for the Holiday API?

There are many potential use cases for the Holiday API, and new ones are being invented all the time. Some of the more common uses cases are the following:

  1. Improving personalization of digital or offline marketing efforts by tailoring your messaging to the holidays of each specific user once you have identified their location, such as through IP Geolocation. Conversely, you can avoid certain types of marketing on or around certain holidays.
  2. Improving expectations around service availability, such as support and operations by notifying users of local holidays.
  3. Personalizing emails, chats, and other interfaces by adapting them to or mentioning a user’s local holidays.

These are just examples and we always love to see what unique and creative solutions our users create with the Holiday API. If you have a creative implementation that you'd like to share with us and use as a case study in exchange for free credits, just email us at

Where does the data for the Holiday API come from?

Holiday data is acquired from a variety of public and private sources. Wherever possible we attempt to use official government data that’s cross referenced by one or more additional sources. For example, in the US, the U.S. Office of Personnel Management (OPM), which serves as the chief human resources agency and personnel policy manager for the Federal Government, maintains a list of federal holidays. The State of California maintains their own set of holidays, some of which overlap with the federal government’s, and some of which do not. Abstract’s Holiday API identifies and validates all these dates so you don’t have to.

What types of holidays does the API cover?

The Holiday API starts with officially-recognized government holidays as its basis for the holiday data. As mentioned above, this data is cross checked with as many other data sources as possible to ensure it's accurate. There are several other categories of holidays, such as religious holidays which may not be observed or only semi-observed by the government. In cases where the given national or state/province does not recognize the holiday, then it does not appear in our Holiday API. However, we are working on enriching our data set with non-observed religious and other such holidays. If you're interested in contributing to or using this data, please contact us.

What countries, regions, and time frames does the Holiday API cover?

The countries and territories covered by the API include: Afghanistan, Albania, Algeria, American Samoa, Andorra, Angola, Anguilla, Antarctica, Antigua and Barbuda, Argentina, Armenia, Aruba, Australia, Austria, Azerbaijan, Bahamas, Bahrain, Bangladesh, Barbados, Belarus, Belgium, Belize, Benin, Bermuda, Bhutan, Bolivia, Bosnia and Herzegovina, Botswana, Bouvet Island, Brazil, British Indian Ocean Territory, Brunei Darussalam, Bulgaria, Burkina Faso, Burundi, Cambodia, Cameroon, Canada, Cape Verde, Cayman Islands, Central African Republic, Chad, Chile, China, Colombia, Comoros, Congo, Cook Islands, Costa Rica, Cote D'Ivoire (Ivory Coast), Croatia, Cuba, Cyprus, Czech Republic, Denmark, Djibouti, Dominica, Dominican Republic, East Timor, Ecuador, Egypt, El Salvador, Equatorial Guinea, Eritrea, Estonia, Ethiopia, Falkland Islands (Malvinas), Faroe Islands, Fiji, Finland, France, France, Metropolitan, French Guiana, French Polynesia, French Southern Territories, Gabon, Gambia, Georgia, Germany, Ghana, Gibraltar, Greece, Greenland, Grenada, Guadeloupe, Guam, Guatemala, Guinea, Guinea-Bissau, Guyana, Haiti, Heard and McDonald Islands, Honduras, Hong Kong, Hungary, Iceland, India, Indonesia, Iran, Iraq, Ireland, Israel, Italy, Jamaica, Japan, Jordan, Kazakhstan, Kenya, Kiribati, Korea (North), Korea (South), Kuwait, Kyrgyzstan, Laos, Latvia, Lebanon, Lesotho, Liberia, Libya, Liechtenstein, Lithuania, Luxembourg, Macau, Macedonia, Madagascar, Malawi, Malaysia, Maldives, Mali, Malta, Marshall Islands, Martinique, Mauritania, Mauritius, Mayotte, Mexico, Micronesia, Moldova, Monaco, Mongolia, Montserrat, Morocco, Mozambique, Myanmar, Namibia, Nauru, Nepal, Netherlands, Netherlands Antilles, New Caledonia, New Zealand, Nicaragua, Niger, Nigeria, Niue, Norfolk Island, Northern Mariana Islands, Norway, Oman, Pakistan, Palau, Panama, Papua New Guinea, Paraguay, Peru, Philippines, Pitcairn, Poland, Portugal, Puerto Rico, Qatar, Reunion, Romania, Russian Federation, Rwanda, Saint Kitts and Nevis, Saint Lucia, Saint Vincent and The Grenadines, Samoa, San Marino, Sao Tome and Principe, Saudi Arabia, Senegal, Seychelles, Sierra Leone, Singapore, Slovak Republic, Slovenia, Solomon Islands, Somalia, South Africa, Spain, Sri Lanka, St. Helena, St. Pierre and Miquelon, Sudan, Suriname, Svalbard and Jan Mayen Islands, Swaziland, Sweden, Switzerland, Syria, Taiwan, Tajikistan, Tanzania, Thailand, Togo, Tokelau, Tonga, Trinidad and Tobago, Tunisia, Turkey, Turkmenistan, Turks and Caicos Islands, Tuvalu, Uganda, Ukraine, United Arab Emirates, United Kingdom (Britain / UK), United States of America (USA), US Minor Outlying Islands, Uruguay, Uzbekistan, Vanuatu, Vatican City State (Holy See), Venezuela, Viet Nam, Virgin Islands (British), Virgin Islands (US), Wallis and Futuna Islands, Western Sahara, Yemen, Yugoslavia, Zaire, Zambia, and Zimbabwe.

Get your free
Holidays API
key now
4.8 from 1,863 votes
See why the best developers build on Abstract
get free api key
No credit card required