🌍 World Holidays API

🚀 API Endpoints

🏳️ Supported Countries

📅 Interactive Holiday Calendar

💻 Usage Examples

import 'package:world_holidays/world_holidays.dart';

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

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

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 -X GET "https://beomq.github.io/world_holidays/api/countries.json"

📊 Data Structure

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

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

🔗 Links

• 📦 pub.dev Package
• 💻 GitHub Repository
• 📖 Documentation
• 🐛 Report Issues