DEV Community

Cover image for Nager.Date - Free API WorldWide Public Holiday
YURII DE.
YURII DE.

Posted on

Nager.Date - Free API WorldWide Public Holiday

Nager.Date is an open-source holiday Web API designed to simplify the retrieval of public holiday information for over 100 countries. Hosted at https://date.nager.at and maintained on GitHub (https://github.com/nager/Nager.Date), the API offers developers a straightforward REST interface to fetch holiday data, long-weekend calculations, and real-time holiday checks for IoT and other applications (date.nager.at).

Key Benefits and Features

  • Wide Coverage: Access holiday data for more than 100 nations, including regional subdivisions where applicable (date.nager.at).
  • Always Up-to-Date: The API is continuously updated to reflect legislative changes and newly declared holidays (date.nager.at).
  • No Rate Limits & CORS Support: Unlimited requests and cross-origin resource sharing enable easy integration in web and mobile applications without complex workarounds (date.nager.at).
  • Simple Implementation: Endpoints follow a consistent pattern, requiring only HTTP GET calls with URL parameters for year and country code.

Core Endpoints

  1. Get Public Holidays
  • Endpoint: GET /api/v3/PublicHolidays/{Year}/{CountryCode}
  • Example: https://date.nager.at/api/v3/PublicHolidays/2025/AT retrieves all Austrian public holidays in 2025.
  • Response Model: Returns an array of objects with fields such as date, localName, name, countryCode, fixed, global, counties, launchYear, and types (e.g., Public, Bank, School) (date.nager.at).
  1. Long Weekend Calculation
  • Endpoint: GET /api/v3/LongWeekend/{Year}/{CountryCode}
  • Usage: Identifies holiday sequences paired with adjacent weekends to find extended breaks.
  1. Today’s Holiday Check
  • Endpoint: GET /api/v3/IsTodayPublicHoliday/{CountryCode}
  • Usage: Returns a boolean indicating if the current date is a public holiday in the specified country—ideal for IoT devices or automated workflows.
  1. Country and Coverage Metadata
  • Available Countries: GET /api/v3/AvailableCountries lists supported ISO 3166-1 alpha-2 codes.
  • Country Coverage Page: An HTML overview of all covered countries by region. Currently, Europe and Antarctica are fully supported, while other continents have varying levels of availability (date.nager.at).

Geographical Coverage
Holidays have been catalogued for regions across Europe (e.g., Austria, Germany, Ukraine), the Americas, Asia, Africa, Oceania, and Antarctica. Each region lists “Available” and “Missing” countries to help developers anticipate gaps in data for specific locales (date.nager.at).

Top comments (0)