Holidays API

Introduction

AnyAPI’s Holidays API allows you to retrieve a list of public, non-public, and religious holidays for various countries, states, and regions. You can use public holidays api to obtain information about holidays in specific locations or check if a particular date is a holiday.

Features

• Endpoint for Checking Holidays: Public holidays API provides an endpoint that allows you to check whether a specific date is a holiday or not. By sending a request to this endpoint with the desired country and date, you can obtain information about the holiday(s) on that date, if any.
• Endpoint for Retrieving Holiday List: API for holidays offers an endpoint to retrieve a list of holidays for a specific country. By specifying the country in the request, you can get a response containing details of various holidays, including the date, start and end times, name, type (public, observance, etc.), and rule (if applicable).
• Country, State, and Region Support: Holidays API supports 200+ countries, states, and regions, allowing you to fetch holiday information for a wide range of locations globally. You can specify the desired country or region in your API requests to get the corresponding holiday data.
• Localization: The API supports multiple languages, allowing you to retrieve holiday information in different languages. By specifying the desired language in the request, you can receive holiday names and other details in that particular language.
• Datetime Parsing and Validation: Free holidays API includes functionality for parsing and validating datetime values. This ensures that the dates and times provided in the API requests are correctly interpreted and conform to the expected format.

Getting Started

To get started with the holidays API, you can create your API key for free on the AnyAPI.io platform. The API key is used for authentication and should be included in the request URL as a query parameter.

Let’s Try Sign In.

Supported Countries List

Below are the list of countries supported by the Holiday endpoints

curl --request GET \
  --url 'https://anyapi.io/api/v1/holidays/check?date=2021-01-01%2000%3A00%3A00%20GMT%2B0000&country=US&apiKey=YOUR_API_KEY'

{
  "date": "2021-01-02",
  "country": "US",
  "holiday": [
    {
      "date": "2021-01-01 00:00:00",
      "start": "2021-01-01T05:00:00.000Z",
      "end": "2021-01-02T05:00:00.000Z",
      "name": "New Year's Day",
      "type": "public"
    }
  ]
}

curl --request GET \
  --url 'https://anyapi.io/api/v1/holidays?country=US&state=SOME_STRING_VALUE&region=SOME_STRING_VALUE&language=SOME_STRING_VALUE&year=2022&apiKey=YOUR_API_KEY'

{
  "country": "US",
  "state": "",
  "region": "",
  "holidays": [
    {
      "date": "2021-01-01 00:00:00",
      "start": "2021-01-01T05:00:00.000Z",
      "end": "2021-01-02T05:00:00.000Z",
      "name": "New Year's Day",
      "type": "public",
      "rule": "01-01 and if sunday then next monday if saturday then previous friday"
    }
  ]
}