Non-Working Days API – Global Holiday & Scheduling Solutions

Overview

The Non-Working Days API offers a programmatic interface for retrieving public holiday data across more than 250 countries and sub-regions. This service is designed for developers who need to incorporate accurate, up-to-date holiday schedules into their software. Typical applications include enterprise resource planning (ERP) systems, customer relationship management (CRM) platforms, and custom business applications that require precise date calculations, such as project management tools or financial systems. By providing a centralized source of holiday information, the API helps automate the identification of non-working days, which is crucial for calculating delivery dates, setting appointment availabilities, or processing salary payments.

Developers can query the API for holidays based on specific years, countries, and even states or provinces, ensuring granular control over the data retrieved. This prevents the need for manual maintenance of complex holiday calendars, which can vary significantly by jurisdiction and change annually. The API returns structured data, typically in JSON format, detailing holiday names, dates, and types (e.g., national, regional, religious). For instance, a logistics company might use the data to adjust shipping estimates when crossing national borders or during peak holiday seasons. A financial institution could use it to determine which days are valid for transaction processing, adhering to local banking regulations.

The Non-Working Days API is suitable for a range of use cases beyond simple holiday listing. It supports complex business logic where the distinction between a working day and a non-working day is critical. This includes calculating service level agreement (SLA) deadlines that exclude weekends and public holidays, optimizing staff scheduling in multinational organizations, or ensuring compliance with local labor laws regarding overtime calculations. The API's RESTful design promotes straightforward integration into existing development workflows, with clear examples provided for common programming languages. This focus on developer experience aims to reduce implementation time and potential errors associated with managing disparate holiday data sources.

For systems that require real-time holiday information, the API offers consistent availability. This is particularly relevant for applications that dynamically adjust their behavior based on the current date and location. For example, an e-commerce platform could integrate holiday data to display accurate shipping cut-off times, or an international support desk could automatically route calls based on the working hours in different time zones, taking local holidays into account. Tools like Tray.io's automation platform often rely on such external data sources to power their workflow automation, illustrating the broad utility of holiday APIs in modern business processes.

Key features

• Global Holiday Data: Access public holiday information for over 250 countries and sub-regions, including states and provinces, ensuring accurate local holiday recognition.
• Historical and Future Dates: Retrieve holiday data for past years and upcoming years, supporting long-term planning and historical analysis.
• Localized Holiday Names: Provides holiday names in their local language and English translations, aiding international communication and application localization.
• Holiday Type Classification: Categorizes holidays (e.g., public, religious, observance) for refined filtering and conditional logic within applications.
• RESTful API Interface: A standard RESTful architecture with JSON responses, designed for ease of integration into web and mobile applications.
• Customizable Queries: Filter holiday requests by country, year, and specific region to fetch only the necessary data points, optimizing bandwidth and processing.
• Clear Documentation and Examples: Non-Working Days API documentation includes practical code examples in multiple languages (cURL, Python, JavaScript, PHP, Ruby) to expedite integration.

Pricing

Non-Working Days offers a free tier and several paid plans as of May 2026. Details are available on the Non-Working Days pricing page.

Common integrations

• Project Management Tools: Integrate non-working days to adjust project timelines and sprint planning, ensuring realistic deadlines.
• HR and Payroll Systems: Automatically account for public holidays in attendance tracking, leave management, and payroll calculations.
• E-commerce Platforms: Provide accurate shipping and delivery estimates by excluding non-working days in various regions.
• Customer Service Systems: Adjust SLA timers and customer support availability based on regional holidays.
• Logistics and Supply Chain Management: Optimize route planning and delivery schedules by knowing when ports, customs, or businesses are closed.
• Scheduling and Booking Applications: Prevent bookings or appointments on public holidays, improving user experience and operational efficiency.

Alternatives

• AbstractAPI Holidays API: Offers a holiday API as part of a suite of microservices, focusing on ease of use.
• Holiday API: Provides global holiday data with a focus on comprehensive coverage and a simple API interface.
• Calendarific: A holiday API that includes extensive historical data and supports a wide range of countries and languages.

Getting started

To begin using the Non-Working Days API, you first need to obtain an API key, which can be acquired by signing up on their homepage. Once registered, you can make your first API call to retrieve holiday data for a specific country and year. The following example demonstrates how to fetch all public holidays in the United States for the year 2024 using cURL. This command targets the /holidays endpoint, passing your API key and specifying the desired country code and year as query parameters. The API will respond with a JSON object containing an array of holiday entries, each with details such as the holiday name, date, and type.

curl -X GET \
  'https://api.nonworkingdays.com/holidays?api_key=YOUR_API_KEY&country=US&year=2024' \
  -H 'Accept: application/json'

After executing this cURL command with your actual API key, the response will be a JSON payload similar to the following, containing holiday details:

{
  "status": "success",
  "holidays": [
    {
      "name": "New Year's Day",
      "name_local": "New Year's Day",
      "date": "2024-01-01",
      "country": "US",
      "type": "public_holiday",
      "federal": true
    },
    {
      "name": "Martin Luther King, Jr. Day",
      "name_local": "Birthday of Martin Luther King, Jr.",
      "date": "2024-01-15",
      "country": "US",
      "type": "public_holiday",
      "federal": true
    },
    // ... more holidays
  ]
}

This output demonstrates how the API provides structured data for each holiday, allowing developers to easily parse and integrate it into their applications. You can adapt this example to query for different countries or years by modifying the country and year parameters in the URL. For further integration, consult the extensive API reference documentation that includes examples for multiple programming languages such as Python, JavaScript, and PHP, alongside details on all available endpoints and parameters.