Get Your Holidays API Key
Buy a plan and get instant access to holiday data for 230+ countries
Pro Plan
Annual subscription
- Unlimited API requests
- Access to all 230+ countries
- Commercial use allowed
$99 /year
Lifetime Access
One-time payment
- All Pro Plan features
- No recurring payments
- Priority support
$249 forever
What is the Holidays API?
The 11holidays Holidays API is a REST API for public holidays, bank holidays and observances in 230+ countries. Send a GET request with a country code and year, and it returns federal, state and local holidays as JSON, with each holiday's name, date, type and description.
HR and leave management
Payroll
Booking and scheduling
API Documentation
Base URL
https://api.11holidays.com/v1Endpoints
GET /holidays?country=US&year=2026- Holidays for a country and year
GET /holidays/{id}- A single holiday by id
GET /countries- Supported countries
GET /occasions- Holidays and festivals with descriptions
Authentication
Include your API key in the request header:
Authorization: Bearer YOUR_API_KEYExample response
[
{
"holiday_id": 6093,
"name": "New Year's Day",
"date": "2026-01-01",
"description": "...",
"occasion_id": 6220,
"country": "US",
"type": "Federal Holiday"
}
]curl -X GET "https://api.11holidays.com/v1/holidays?country=US&year=2026" \
-H "Authorization: Bearer YOUR_API_KEY"Frequently asked questions
What is the 11holidays Holidays API?
It is a REST API that returns public holidays, bank holidays and observances for 230+ countries as JSON. You request holidays by ISO 3166-1 alpha-2 country code and year.
How do I get a Holidays API key?
Buy the Pro or Lifetime plan on this page. After payment you return here to generate your key, and we also email it to the address you used at checkout.
How much does the Holidays API cost?
The Pro plan is $99 per year and Lifetime access is a one-time payment of $249. Both plans include unlimited API requests and all 230+ countries.
Is there a free Holidays API?
The REST API requires a paid plan. Free iCal calendar feeds for each country are available without an API key.
Which countries does the Holidays API cover?
It covers 230+ countries. Call GET /countries for the full list of supported countries and their codes.
Can I get holidays for past years?
Yes. Historical data is included, so you can request past years with the year parameter.
How do I authenticate API requests?
Send your key in the Authorization header of every request: Authorization: Bearer YOUR_API_KEY.
Is there an SDK or OpenAPI spec?
Yes. Install the official npm package with npm i 11holidays, or generate a client from the OpenAPI 3.0 spec linked in the API docs.