Open holiday intelligence

WORLD HOLIDAYS

Free holiday data for South Korea, United States, Japan, China, Vietnam, Malaysia, Thailand, Canada, Brazil, and Taiwan

API ONLINE JSON / REST 2024—2028 MIT LICENSE

Countries

Total Holidays

Years (2024-2028)

Cost (Free!)

API Endpoints

Supported Countries

Interactive Holiday Calendar

Select Country:

Remaining This Year

Holidays This Year

Current Year

Loading calendar...

Usage Examples

Flutter/Dart

import 'package:world_holidays/world_holidays.dart';

final worldHolidays = WorldHolidays();
final holidays = await worldHolidays.getHolidays('KR');
print('Found ${holidays.length} Korean holidays');

JavaScript/Web

fetch('https://beomq.github.io/world_holidays/api/holidays/kr.json')
  .then(response => response.json())
  .then(data => {
    console.log(`Found ${data.holidays.length} holidays`);
  });

Python

import requests

url = 'https://beomq.github.io/world_holidays/api/holidays/kr.json'
response = requests.get(url)
data = response.json()
print(f"Found {len(data['holidays'])} holidays")

cURL

curl -X GET "https://beomq.github.io/world_holidays/api/countries.json"

Data Structure

Countries Response

{
  "lastUpdated": "2026-08-21T00:00:00.000Z",
  "totalCountries": 10,
  "supportedCountries": ["KR", "US", "JP", "CN", "VN", "MY", "TH", "CA", "BR", "TW"],
  "supportedYears": [2024, 2025, 2026, 2027, 2028],
  "totalHolidays": 843,
  "countries": [
    {
      "code": "KR",
      "name": "South Korea",
      "flag": "🇰🇷",
      "totalHolidays": 100,
      "dataUrl": "https://beomq.github.io/world_holidays/api/holidays/kr.json",
      "names": {
        "en": "South Korea",
        "ko": "대한민국"
      }
    }
  ]
}

Holiday Response

{
  "country": "KR",
  "countryName": "South Korea",
  "lastUpdated": "2026-08-21T00:00:00.000Z",
  "supportedYears": [2024, 2025, 2026, 2027, 2028],
  "totalHolidays": 100,
  "holidays": [
    {
      "name": "신정",
      "date": "2024-01-01",
      "type": "NATIONAL",
      "description": {
        "en": "New Year's Day",
        "ko": "새해 첫날"
      }
    }
  ]
}