What this API does
The Nager.Date API is a public holiday data service, providing comprehensive holiday information for more than 100 countries. It includes holiday names available in local languages and English, as well as detailed information for specific subdivisions. The API outputs clean JSON, making it ideal for applications needing accurate holiday data.
How it works
Developers can access the API through simple HTTP GET requests. It supports various endpoints that return data in a structured JSON format, facilitating integration with different programming languages and frameworks. This API also calculates business days and detects long weekends, enhancing the functionality of calendar-based applications.
Authentication
No authentication is required to use the Nager.Date API. All endpoints are publicly accessible, allowing developers to integrate the API without the need for API keys or tokens.
Example usage
/v1/holidays/{year}/{countryCode}- Retrieves public holidays for the specified year and country code./v1/longweekends/{year}/{countryCode}- Detects long weekends for the specified year and country code./v1/businessdays/{startDate}/{endDate}/{countryCode}- Calculates the number of business days between two dates for the specified country.
Limits
The Nager.Date API does not impose any rate limits, allowing developers to make as many requests as needed without restrictions.
Ideal use cases
- Building applications for event planning that require holiday information.
- Creating scheduling tools that account for public holidays.
- Developing reminder systems that alert users about upcoming holidays.
- Integrating holiday data into business applications for better planning.