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
- ✓ 1,000,000/month
- ✓ +$0.001 each
- ✓ All endpoints
Frequently asked questions
Real answers to questions developers ask before integrating.