
Public Holidays API Pricing: Which Plan Do You Need?
Choosing a public holidays API plan comes down to two numbers: how many calls your application makes each month, and whether you need date ranges. The HolidaysMap API has a free plan for testing and four paid levels. Each one is priced in euros, with a monthly or a yearly option.
This guide compares the plans and shows which one fits common projects. Check the pricing page for the current prices before you buy.
Plans at a glance
| Plan | Monthly price | Yearly price | Calls per month | Date ranges (start and end) |
|---|---|---|---|---|
| Free | 0 EUR | 0 EUR | 100 | No |
| Basic | 3 EUR | 29 EUR | 10,000 | No |
| Premium | 9 EUR | 79 EUR | 100,000 | Yes |
| Corporate | 19 EUR | 179 EUR | 1,000,000 | Yes |
The Basic, Premium and Corporate plans include customer support. Corporate also includes chart analytics in the dashboard.
Monthly or yearly billing
The yearly price is lower than twelve monthly payments. Compared with twelve monthly payments, the yearly option saves about 19% on Basic, about 27% on Premium and about 21% on Corporate.
If your project is stable and you know you will keep the plan for a year, the yearly option is the cheaper choice. If you are not sure yet, start monthly and switch later. You can upgrade or downgrade whenever you like.
Which plan fits your project
- Free (100 calls a month): testing an integration, a personal project, or a single script that runs once a day. 100 calls a month is about three calls a day.
- Basic (10,000 calls a month): a small website or a booking form that checks a few holidays per visitor. 10,000 calls a month is about 333 a day.
- Premium (100,000 calls a month): a product used by many people, or a backend that needs date ranges such as a full year or a quarter in one request.
- Corporate (1,000,000 calls a month): high-traffic systems, several applications sharing one key, or teams that want chart analytics.
Date ranges are the main reason to choose Premium over Basic. A range request returns every holiday between a start and an end date in a single call. On Free and Basic, a request that includes start and end is rejected. Read the range query guide for the exact request format.
How calls are counted
Each successful request to the holidays endpoint counts as one call. That includes a single-date request and a range request that returns many holidays. A request rejected because of invalid parameters, such as an unsupported date format, is not counted.
Because a range request counts as one call, a yearly calendar takes one call instead of 365. Store the result and reuse it, so your application does not repeat the same call on every page view.
Frequently asked questions
Is there a credit card requirement for the free plan?
No. You can sign up and start with the free plan without entering payment details.
What happens when I reach my monthly limit?
Requests are refused with an error that says the account limit is exceeded. Upgrade to a higher plan to continue. The usage limits article explains the error codes and how to avoid hitting the limit.
Can I switch plans later?
Yes. Upgrade or downgrade whenever you like from your account.
Next steps
- Sign up and try the free plan.
- Read the API documentation for every parameter.
- Compare the supported countries before you choose a plan for a specific market.