Frequently Asked Questions
General Questions
We continuously track holiday changes globally and update our data regularly. While we don’t offer notifications for each update, querying our Holidays API weekly and caching the results will ensure you have the latest information.
Yes, you can specify the country’s ISO code when querying holiday data. To narrow down to a specific state, use the subdivision filter. For example, to retrieve holidays for New South Wales in Australia, use 'subdivision=au-nsw'.
Our APIs are suitable for developers, businesses, project managers, e-commerce platforms, HR departments, and anyone who needs reliable holiday data to plan operations, schedule events, or improve user experiences.
We pride ourselves on providing highly accurate and regularly updated holiday data, a flexible API structure, and tailored features like custom filtering. Plus, our pricing and support are designed to be user-friendly for both startups and enterprises.
Data Coverage
Our rule engine allows for accurate holiday calculations well into the future; for most countries, you can retrieve holiday dates up to the year 2100. However, in some countries, certain holidays are determined only a year in advance, often due to their dependence on astronomical events, like the sighting of the new moon.
Our API covers holidays for over 213 countries, including regional and state-specific holidays where applicable.
Yes, we include a wide range of holidays, including public, religious, government, and observance holidays. You can filter the data based on your specific needs.
API Features
Our API provides features such as retrieving holiday dates for specific countries or regions, filtering holidays by type (e.g., national, regional, government), accessing historical and future holiday data, fetching holidays for specific dates. The API supports JSON format, and we also offer CSV downloads.
Yes, our API is built using REST principles, ensuring ease of integration and compatibility with various platforms.
Absolutely! We offer a free tier that allows limited access to the API for testing and evaluation purposes.
Pricing and Plans
We offer two pricing plans to suit different needs. The Standard Plan is perfect for teams needing reliable and expansive holiday information, providing access to all countries' national holidays, past, current, and future holiday data, and unlimited requests. The Premium Plan is designed for developers or non-developers seeking complete holiday data via API or CSV export, including all Standard Plan features plus regional and government holidays and CSV download capability.
Yes, we support non-profits and educational institutions with discounted plans. Contact us for more details.
No hidden costs! You only pay for the plan you choose, and any overages will be transparently communicated.
Support
Yes, we offer dedicated support via email. Standard and Premium plans include priority support.
Yes, our API documentation is publicly accessible online.