Checkiday - National Holiday API for Global Holiday Data

Overview

The Checkiday National Holiday API offers a programmatic interface for accessing a comprehensive database of national and international holidays, observances, and special events. This API is engineered for developers and technical buyers who need to integrate specific calendar-based information into their software applications. The primary use cases include enhancing scheduling systems, personalizing user experiences based on local observances, and generating relevant content for event-driven marketing campaigns. By providing structured data, the Checkiday API helps applications account for regional specificities in holiday calendars, which can impact business operations, user engagement, and logistical planning.

The API functions via a RESTful architecture, allowing developers to request holiday data using standard HTTP methods. This approach facilitates integration into a wide range of programming environments and existing system architectures. For instance, a scheduling application might use the API to automatically adjust deadlines or meeting suggestions based on public holidays in a user's specified country. Similarly, an e-commerce platform could personalize promotions or website content to align with upcoming national holidays, thereby increasing relevance for its customer base.

Checkiday's offering is particularly useful for platforms that operate across multiple geographies and require accurate, up-to-date holiday information to maintain operational efficiency and cater to diverse user expectations. The data encompasses various types of holidays, including public holidays, religious observances, and cultural events, providing a nuanced understanding of a given date's significance. This level of detail supports sophisticated application logic that goes beyond simple date calculations, enabling developers to build more intelligent and context-aware features. The API's straightforward documentation and clear examples aim to streamline the integration process, allowing development teams to quickly incorporate holiday data without extensive custom parsing or data maintenance efforts.

Key features

• Global Holiday Data: Access to national and international holidays across numerous countries, including public holidays, religious observances, and cultural events.
• Date-Based Queries: Retrieve holidays for specific dates or date ranges, enabling precise scheduling and event planning.
• Country Filtering: Filter holiday results by country to target specific geographical regions for localized application behavior.
• Holiday Type Classification: Data includes classifications for different holiday types, allowing applications to prioritize or display information based on relevance (e.g., bank holidays vs. cultural observances).
• RESTful API: Utilizes standard REST principles for predictable resource-oriented URLs and HTTP response codes, simplifying integration.
• JSON Output: Holiday data is returned in JSON format, which is widely compatible with modern web and mobile application development.

Pricing

Checkiday offers a free tier and several paid plans for its National Holiday API, catering to different usage volumes. The pricing is structured based on the number of API requests per month.

Pricing information is accurate as of May 2026. For the most current details, refer to the Checkiday API pricing page.

Common integrations

The Checkiday National Holiday API can be integrated into various systems and platforms to enhance functionality:

• Calendar Applications: Integrate holiday data to automatically populate user calendars with relevant national and regional observances, improving scheduling accuracy.
• Project Management Tools: Help teams account for public holidays when setting deadlines and planning project timelines to avoid scheduling conflicts.
• Event Management Platforms: Display local holidays to attendees or organizers to inform event timing and marketing efforts.
• HR and Payroll Systems: Automate holiday pay calculations and leave management by cross-referencing official public holidays.
• E-commerce and Marketing Platforms: Tailor promotional campaigns and content delivery to align with national holidays, increasing relevance and engagement.
• Content Management Systems (CMS): Power dynamic content related to holidays, such as blog posts about upcoming observances or seasonal greetings.
• Travel and Hospitality Applications: Inform travelers about local holidays that might affect business hours or public services at their destination.

Alternatives

Developers seeking holiday API solutions may consider various alternatives:

• AbstractAPI Holiday API: Offers holiday data with a focus on simplicity and global coverage for developers.
• Calendarific: Provides access to public, religious, and historical holidays for numerous countries, with filtering capabilities.
• HolidayAPI.com: Delivers holiday data for over 250 countries and 100 languages, often highlighting specific holiday types.
• Google Calendar API: While not a dedicated holiday API, it allows programmatic access to Public Calendars, which often include holiday schedules. This could be a consideration for applications already within the Google ecosystem, though it requires more manual configuration for holiday-specific data compared to specialized holiday APIs, as noted in the Google Calendar API concepts overview.

Getting started

To begin using the Checkiday National Holiday API, you will typically need to sign up for an API key on their website. Once registered, you can make HTTP requests to their endpoints. Here’s a basic example using curl to retrieve holidays for a specific date and country. This example assumes you have an API key (replace YOUR_API_KEY with your actual key).

curl "https://api.checkiday.com/v1/holidays?date=2026-07-04&country=US&api_key=YOUR_API_KEY"

This request would return JSON data detailing the holidays observed on July 4, 2026, in the United States. The API provides clear documentation on available parameters for filtering by date, country, and other criteria. For integrating into specific programming languages, you would use an HTTP client library appropriate for that language (e.g., requests in Python, fetch in JavaScript, HttpClient in C#, or RestTemplate in Java) to construct and send these requests, then parse the resulting JSON payload.

A typical JSON response for a holiday might look like this:

{
  "status": "ok",
  "total": 1,
  "holidays": [
    {
      "id": 12345,
      "name": "Independence Day",
      "date": "2026-07-04",
      "country": "US",
      "type": "National Holiday",
      "description": "Celebrates the adoption of the Declaration of Independence."
    }
  ]
}

Developers should consult the official Checkiday API reference for detailed information on all available endpoints, request parameters, and response structures to fully utilize its capabilities.