REST API · JSON · 230+ countries All systems operational

Worldwide Holidays and Observances RESTful API

Giving you access to public, local, and bank holidays, as well as observances, across more than 230 countries, over 3,300 states, and in more than 100 languages.

Start Now for Free

  • /holidays
  • /countries
  • /languages
Read the API docs
SVG
SVG
SVG

Proudly serving and trusted by over 10,000+ businesses and developers at:

client logo client logo client logo client logo client logo client logo

Why Calendarific?

Beyond the unparalleled holiday data, Calendarific delivers

Speed

We use latency based DNS routing to serve over 90% of all requests handled in less than 10ms.

Reliability

Our cloud-based auto-scaling servers can handle over half a billion API queries per day.

Up to Date

Our data is aggregated and verified from multiple sources and updated regularly.

One Holiday API for Every Workflow

Pick the workflow closest to yours. Every one runs on the same REST endpoint, the same API key, and the same monthly quota.

Get your API key Read the docs

Build pay-date and leave calendars on national holidays

Filter to national holidays only and drop the observances, seasons, and religious dates you do not pay out for. One request per country per year.

/api/v2/holidays200 OK
GET /api/v2/holidays?api_key=YOUR_API_KEY&country=US&year=2026&type=national
// → 12 holidays · "Labor Day" 2026-09-07 · "Thanksgiving Day" 2026-11-26 …
  • national · local · religious · observance
  • Years through 2049
  • Stable holiday UUIDs
Simple authenticationOne API key on the query string. No OAuth dance, no SDK required.
Usage you can seeTrack requests against your monthly quota from the account dashboard.
Country to region230+ countries and 3,300+ states and regions, verified from multiple sources.
Enterprise supportSLA, invoicing, multiple keys, and a dedicated account manager on request.

Worldwide Coverage

An end-to-end platform offering the most comprehensive holiday data from over 230 countries and 3,300 states and regions, in more than 100 languages.

Labor Day Sep 7 Independence Day Sep 7 Christmas Day Dec 25 National Day Oct 1 Heritage Day Sep 24 Janmashtami Sep 4 Respect for the Aged Day Sep 21

Popular countries

Next national holiday for each. Every calendar links to the same data the API returns.

All countries

Showing 230 of 230 countries and territories

Are we missing your country? Let us know!

Plans and Pricing

There's something for everyone. Tiered pricing. No hidden charges. Choose a plan that best fits your needs.

Free

$0.00 /Year

Save $0.00 on yearly plan
  • 500 Calls/month
  • Attribution Required
  • Community Support
  • Single Language
  • Limited Historical Data
  • Limited Upcoming Data
  • Dataset updated quarterly
  • Premium API Parameters
  • CSV/XLS Data Export
  • Ecommerce Ready
  • Multiple API Keys
  • SLA
  • Dedicated account manager
Get Started

Starter

$100.00 /Year

Save $44.00 on yearly plan
  • 10,000 Calls/month
  • No attribution Required
  • Email Support
  • National Languages
  • Complete Historical Data
  • Complete Upcoming Data
  • Dataset updated quarterly
  • Premium API Parameters
  • CSV/XLS Data Export
  • Ecommerce Ready
  • Multiple API Keys
  • SLA
  • Dedicated account manager
Get Started

Business

$500.00 /Year

Save $40.00 on yearly plan
  • 50,000 Calls/month
  • No attribution Required
  • Priority Support
  • All Languages
  • Complete Historical Data
  • Complete Upcoming Data
  • Dataset updated weekly
  • Premium API Parameters
  • CSV/XLS Data Export
  • Ecommerce Ready
  • Multiple API Keys
  • SLA
  • Dedicated account manager
Get Started

Enterprise

$4,000.00 /Year

Save $800.00 on yearly plan
  • 50,000,000 Calls/month
  • No attribution Required
  • Dedicated Support
  • All Languages
  • Complete Historical Data
  • Complete Upcoming Data
  • Dataset updated daily
  • Premium API Parameters
  • CSV/XLS Data Export
  • Ecommerce Ready
  • Multiple API Keys
  • SLA
  • Dedicated account manager
Get Started

Free

$0.00 /Month

Save $0.00 on yearly plan
  • 500 Calls/month
  • Attribution Required
  • Community Support
  • Single Language
  • Limited Historical Data
  • Limited Upcoming Data
  • Dataset updated quarterly
  • Premium API Parameters
  • CSV/XLS Data Export
  • Ecommerce Ready
  • Multiple API Keys
  • SLA
  • Dedicated account manager
Get Started

Starter

$12.00 /Month

Save $44.00 on yearly plan
  • 10,000 Calls/month
  • No attribution Required
  • Email Support
  • National Languages
  • Complete Historical Data
  • Complete Upcoming Data
  • Dataset updated quarterly
  • Premium API Parameters
  • CSV/XLS Data Export
  • Ecommerce Ready
  • Multiple API Keys
  • SLA
  • Dedicated account manager
Get Started

Business

Unavailable on
Monthly Plans

Save $40.00 on yearly plan
  • 50,000 Calls/month
  • No attribution Required
  • Priority Support
  • All Languages
  • Complete Historical Data
  • Complete Upcoming Data
  • Dataset updated weekly
  • Premium API Parameters
  • CSV/XLS Data Export
  • Ecommerce Ready
  • Multiple API Keys
  • SLA
  • Dedicated account manager
Get Started

Enterprise

Unavailable on
Monthly Plans

Save $800.00 on yearly plan
  • 50,000,000 Calls/month
  • No attribution Required
  • Dedicated Support
  • All Languages
  • Complete Historical Data
  • Complete Upcoming Data
  • Dataset updated daily
  • Premium API Parameters
  • CSV/XLS Data Export
  • Ecommerce Ready
  • Multiple API Keys
  • SLA
  • Dedicated account manager
Get Started

Enterprise-Ready. Reach out for custom quotes and invoicing.

We offer custom premium plans with bespoke pricing for enterprise plans, invoicing, dedicated technical account support and more.

Book a demo

Frequently Asked Questions

Explore the FAQs to discover more about Calendarific's functionalities and make the most of its diverse holiday data integration services. If you have any other questions or require further assistance, our dedicated support team is here to help.

Calendarific is a powerful API that provides comprehensive holiday data and business hours for over 230 countries worldwide. It allows developers and businesses to integrate holiday information seamlessly into their applications, websites, or services.

To access the Calendarific API, you need to sign up for an API key on the Calendarific website. Once you have your API key, you can start making requests to retrieve holiday data.

Calendarific offers a vast array of holiday data, including national holidays, local observances, religious holidays, and more. You can obtain details such as holiday names, dates, types, and even customize the data based on specific countries or regions.

Absolutely! Calendarific is designed to cater to the needs of individuals, businesses, and developers alike. Whether you want to keep track of holidays in your personal calendar or integrate holiday data into your commercial application, Calendarific offers a user-friendly solution for all.

Yes, Calendarific is versatile and can be integrated into various platforms, including websites, mobile apps, and other software applications. The API provides easy-to-follow documentation, making implementation a breeze.

Yes, the free subscription plan has a limited number of API requests per month. For higher usage or more advanced features, premium subscription plans are available.

Calendarific employs the secure and trusted payment gateway, Stripe, to process all premium subscription payments. Stripe ensures that your payment information is handled with the utmost confidentiality and follows industry-leading security standards. With Stripe, you can confidently subscribe to our premium services, knowing that your financial data is protected.

As per our policy, Calendarific does not offer refunds for premium subscription payments. However, we are committed to providing exceptional service and addressing any concerns you may have. If you encounter any issues or need assistance, our dedicated customer support team is always available to help resolve your queries promptly.