Date & Time

Public Holidays API

List official public holidays for any supported country and year, with local and English names.

Request Headers

Name	Required	Description
`X-RapidAPI-Key`	required	Your RapidAPI key. Get one free.
`X-RapidAPI-Host`	required	`holidays.p.rapidapi.com`

Endpoints

GET /v1/holidays

List public holidays for a country and year

Parameters

Name	Type	Required	Default	Constraints
`country`	string	required	—	matches \S
`year`	integer	optional	—	2020-2035

Code Examples

curl --request GET \
  --url 'https://holidays.p.rapidapi.com/v1/holidays?country=example' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: holidays.p.rapidapi.com'

const url = "https://holidays.p.rapidapi.com/v1/holidays?country=example";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "holidays.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://holidays.p.rapidapi.com/v1/holidays"

querystring = {"country": "example"}

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "holidays.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())

GET /v1/holidays/countries

List all countries that have holidays in the dataset, sorted alphabetically by ISO code.

Code Examples

curl --request GET \
  --url 'https://holidays.p.rapidapi.com/v1/holidays/countries' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: holidays.p.rapidapi.com'

const url = "https://holidays.p.rapidapi.com/v1/holidays/countries";
const options = {
  method: "GET",
  headers: {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "holidays.p.rapidapi.com"
  }
};

const response = await fetch(url, options);
const data = await response.json();
console.log(data);

import requests

url = "https://holidays.p.rapidapi.com/v1/holidays/countries"

headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "holidays.p.rapidapi.com"
}

response = requests.get(url, headers=headers)

print(response.json())

Interactive Example

holidays

$ GET /v1/holidays?country=US&year=2025
{"data":[{"date":"2025-07-04","local_name":"Independence Day","name":"Independence Day","country":"US","types":["Public"]}],"meta":{"total":1,"limit":1,"offset":0}}

Subscribe & License

Access this API with commercial-ready tiers on RapidAPI. Flexible plans designed for side-projects, startups, and high-volume production architectures.

View Pricing & Subscribe

Developer Support

Need help integrating or have a custom endpoint request? Our engineering team is here to assist with authentication, payload schemas, and high-frequency rate limit increases.

Contact API Engineering

System Performance

Monitored 24/7 with a 99.9% uptime SLA. Built atop cloud-native microservices with globally distributed edge caching to ensure ultra-low latency response times.

All Systems Operational