LogoPublic Holidays API

Accurate Public Holiday Data
For Every Country/Region

Free and open-source API providing comprehensive public holiday information for 59 countries/regions worldwide. Perfect for scheduling, calendar apps, and HR systems.

Try It NowView Documentation

Why Choose Our API?

🌐

59 Countries/Regions Covered

Comprehensive coverage across Asia-Pacific, Europe, Americas, Middle East, and Africa with accurate regional data.

📅

Historical & Future Data

Access holiday data for 2023 and forward, with plans to expand further.

🎯

Rich Metadata

Includes local names, holiday types, duration support.

Try It Out

Test the API right here in your browser

API Endpoint

GET /api/public-holidays?year=2025&code=cn

API Documentation

Endpoint

GET /api/public-holidays

Query Parameters

ParameterTypeDescription
yearstringYear (e.g., "2024", "2025")
codestringISO 2-letter country/region code (e.g., "cn", "us", "uk")

Response Format

{
data: [
0: {
localName: "元旦"
name: "New Year's Day"
code: "CN"
fixed: true
global: true
counties: null
launchYear: null
types: [
0: "Public"
]
startDate: "2025-01-01T00:00:00.000Z"
endDate: "2025-01-01T23:59:59.999Z"
}
]
}

Supported Countries & Regions (59)

United Arab Emirates
AE
Argentina
AR
Austria
AT
Australia
AU
Barbados
BB
Bangladesh
BD
Belgium
BE
Brazil
BR
Canada
CA
Switzerland
CH
Chile
CL
China
CN

Example Usage

JavaScript / Fetch API

1fetch('https://public-holidays.toolhub.run/api/public-holidays?year=2025&code=cn')
2  .then(res => res.json())
3  .then(console.log)

cURL Command

1curl "https://public-holidays.toolhub.run/api/public-holidays?year=2025&code=cn"

Python / Requests

1import requests
2
3response = requests.get(
4    'https://public-holidays.toolhub.run/api/public-holidays',
5    params={'year': '2025', 'code': 'cn'}
6)
7data = response.json()
8print(data)