Public HolidaysPublic holidays for 100+ countries
The Helix Public Holidays API returns official public holidays for 100+ countries — every holiday for a given year, the next upcoming holidays, and the full list of supported countries. Sourced from the open Nager.Date project and refreshed on every release.
- Free tier with 100 requests/month
- Fast, cached responses
- 99.9% uptime target
- Standard REST + JSON
What is the Public Holidays API?
The Helix Public Holidays API returns official public holidays for 100+ countries — every holiday for a given year, the next upcoming holidays, and the full list of supported countries. Sourced from the open Nager.Date project and refreshed on every release.
How it works
- 1GET /holidays?country=DE&year=2026 returns every public holiday for Germany in 2026.
- 2GET /next?country=US returns upcoming holidays in the next 365 days.
- 3GET /countries returns the complete list of supported country codes.
- 4Each holiday includes ISO date, English name, local name, country code, and whether it's national or regional.
- 5Responses are cached for 24 hours — the holiday list barely changes within a year.
Endpoints
3 REST endpoints, all returning consistent JSON.
/holidaysAll public holidays for a country and year
/nextUpcoming holidays for a country (next 365 days)
/countriesList all supported countries
Code in 5 languages
Copy and paste into your project. Replace YOUR_API_KEY with your RapidAPI key.
// Public Holidays API
const response = await fetch(
"https://public-holidays-by-helix-api.p.rapidapi.com/holidays"
{
headers: {
"X-RapidAPI-Key": "YOUR_API_KEY",
"X-RapidAPI-Host": "public-holidays-by-helix-api.p.rapidapi.com"
}
}
);
const data = await response.json();
console.log(data);What developers build with this API
Real use cases from production deployments.
HR & Payroll Systems
Block PTO requests on national holidays. Pre-fill leave calendars for new hires. Cross-check overtime calculations against bank-holiday rules.
Scheduling & Booking
Hide unavailable dates in restaurant or appointment bookers when staff aren't working.
Trading Platforms
Show market-closed badges automatically on equity, futures, and bond instruments.
Travel & Logistics
Warn customers about delivery delays and surge pricing windows around public holidays.
Pricing
All tiers include this API. No credit card for free tier.
BASIC
Free
- ✓ 100 reqs/month
- ✓ Hard limit
- ✓ All endpoints
PRO
$9.99/mo
- ✓ 10,000/month
- ✓ +$0.005 each
- ✓ All endpoints
ULTRA
$29.99/mo
- ✓ 100,000/month
- ✓ +$0.002 each
- ✓ All endpoints
MEGA
$99.99/mo
- ✓ 1M+/month
- ✓ +$0.001 each
- ✓ All endpoints
Frequently asked questions
Real answers to questions developers ask before integrating.
Which countries are supported?
Are regional holidays included?
Are religious holidays included?
Do you support historical years?
What about variable/movable holidays?
More Data & Utilities APIs
Ready to integrate Public Holidays?
Get started with 100 free requests. No credit card. Production-ready in minutes.