Holidays

Get a list of public holidays for any country and year. Useful for building calendar apps, scheduling, and compliance tools.

Get API Key

Overview

Use Cases

Calendar applications
Scheduling and booking systems
Compliance and deadline tracking
Travel and logistics planning

Features

Support for 190+ countries

National and public holidays

Yearly calendar data

Fast response times

API Endpoints

Get Holidays

Returns a list of public holidays for the specified country and year

GET

https://api.requiems.xyz/v1/places/holidays

Parameters

Name	Type	Required	Description
country	`string`	Required	ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "DE")
year	`integer`	Required	Year for which to retrieve holidays (e.g., 2025)

Try it out

Live Demo

Request

country * (string)

ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "DE")

year * (integer)

Year for which to retrieve holidays (e.g., 2025)

Response Fields

Field	Type	Description
country	`string`	ISO 3166-1 alpha-2 country code
year	`integer`	Year for which holidays are returned
holidays	`array`	Array of holiday objects
holidays[].date	`string`	Holiday date in YYYY-MM-DD format
holidays[].name	`string`	Name of the holiday
total	`integer`	Total number of holidays for the country/year

Code Examples

curl "https://api.requiems.xyz/v1/places/holidays?country=US&year=2025" \
  -H "requiems-api-key: YOUR_API_KEY"

import requests

url = "https://api.requiems.xyz/v1/places/holidays"
params = {"country": "US", "year": 2025}
headers = {"requiems-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers, params=params)
print(response.json())

const response = await fetch('https://api.requiems.xyz/v1/places/holidays?country=US&year=2025', {
  headers: {
    'requiems-api-key': 'YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data.data.holidays);

require 'net/http'
require 'json'

uri = URI('https://api.requiems.xyz/v1/places/holidays')
uri.query = URI.encode_www_form(country: 'US', year: 2025)
request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)
puts data['data']['holidays']

Error Responses

bad_request

Missing or invalid country code or year parameter

not_found

No holidays found for the specified country and year

No results found

Sin resultados