Terms of Use & Data Quality Guarantee
Last updated:
API usage
A valid API key allows you to use the Working Days API from any IP address or web origin, subject to your plan's usage limits. The API supports cross-origin requests (CORS). You may integrate API results into your applications and services, including commercial products. However, you may not resell or sublicense the data itself, or redistribute it as a standalone dataset or competing API service. You may not sublicense your API access to a third party.
Public holiday coverage
Working Days provides public holiday data across 58 countries and 373 regional configurations. Our presets include national and regional calendars, with selected local, public-sector and banking configurations. See the supported countries and configurations for the available territories, presets and holiday languages.
The applicable holidays depend on the configuration selected. A national preset does not automatically include every regional or municipal holiday, and a public-sector or banking calendar may differ from the general calendar. Commemorations do not, by themselves, create a non-working day.
How we maintain data quality
Our historical calendar research extends back to 2000. We review public holiday legislation, official gazettes and calendars published by the relevant authorities, giving priority to primary sources.
These reviews examine more than recurring dates: they address when a holiday was introduced or abolished, changes to its date, substitute-day rules, annual regional choices and documented exceptional holidays. Automated checks compare calculations with reference dates and verify consistency between regional identifiers and configuration options.
Historical coverage is not uniform across every territory and year. Some calendars are reconstructed from the legislation applicable at the time; others rely on published annual calendars. Local exceptions and exceptional closures may require further research. An audit records the scope reviewed; it is not a claim that every historical closure has been independently verified.
Historical dates and guarantee period
Our data quality guarantee covers public holiday dates from 1 January 2000 up to and including the current date, across all supported countries and regional preset configurations. This refund commitment applies to confirmed errors within the scope of the selected preset, as described below.
User-defined dates and changes you make to a preset configuration are outside the scope of this guarantee.
Data quality guarantee
If you report a confirmed error in an official public holiday date or its inclusion in one of our preset configurations within the period above, we will refund your subscription fee in full for the month in which you report it. This includes an official public holiday that is missing, listed on the wrong date, or incorrectly included.
To request a refund, contact us with the country, preset configuration, affected date and a description of the error. An official source, if available, will help us verify your report.
Dates before 1 January 2000 and future dates are outside this refund guarantee. Service availability is covered separately by our Service Level Agreement (SLA).
Future dates and calendar updates
Future calendars may use dates already published by the relevant authorities or projections based on the rules currently in force. Dates that have not yet been officially confirmed are indicative and may change. Even published future calendars can be amended by the authorities.
Publication schedules vary by country. Some calendars depend on annual announcements, including exceptional days off and transfers of working days. We incorporate official changes as soon as possible after they are announced.
Changes affecting dates, calculation rules, configuration options and holiday translations are published in the API changelog. Where a change requires action by API clients, the entry explains the compatibility or migration requirements.
Plan cancellation
You can cancel your plan at any time through your subscriber console or through PayPal's automatic payment settings. Your API key remains active until the end of the paid billing period.
If you subsequently subscribe again using the same PayPal account, you will receive a new API key.
Plan changes
You can upgrade or downgrade your plan through your subscriber console. The existing plan is terminated and the new plan is activated. Your API key remains unchanged. Billing for the previous plan stops and billing for the new plan begins when the change takes effect.
Payment failures
If a subscription payment fails, Working Days will cancel the plan.
Request history
Your API calls are logged and retained for three months. You can review this request history in your subscriber console during that period. See our Privacy Policy for information about personal data.
Customer references
Working Days reserves the right to identify you as a customer on this website using your trade name and trademark logo.