{
  "name": "Korea Calendar API",
  "by": "KunStudio",
  "version": "1.2.0",
  "description": "Korean holidays API + lunar-to-solar conversion API + sexagenary cycle (간지/gapja) API + Korea 24 solar terms (절기) API + Korean Revised Romanization API. One endpoint set for Korean calendar, fortune (사주/saju), and localization apps.",
  "use_cases": [
    "Show Korean public holidays in a calendar/booking app",
    "Convert birth dates to lunar + 간지 for saju / fortune apps",
    "Get 24 solar terms (절기) entry times for seasonal content",
    "Romanize Korean names/text (RR) for travel & localization"
  ],
  "endpoints": {
    "GET /v1/holidays?year=2026": "Korean public holidays for a year (incl. 대체공휴일)",
    "GET /v1/holidays/is?date=2026-02-17": "is the date a public holiday? (+ weekday)",
    "GET /v1/today": "today's KR date (KST) + holiday status",
    "GET /v1/romanize?text=안녕하세요": "Revised Romanization (RR) of Korean",
    "GET /v1/lunar/solar-to-lunar?date=2026-02-17": "solar→lunar + 간지",
    "GET /v1/lunar/lunar-to-solar?date=2026-01-01&leap=false": "lunar→solar (optional leap month)",
    "GET /v1/gapja?date=2026-02-17": "간지 (sexagenary cycle) year/month/day pillars for a solar date",
    "GET /v1/solar-terms?year=2026": "24 solar terms (절기), KST — astronomically computed, any year",
    "GET /v1/solar-terms?date=2026-03-20": "is this KST date a solar term? (returns the term or null)",
    "GET /v1/health": "liveness"
  },
  "coverage": {
    "holidays": "2026–2027 (bundled, verified).",
    "lunar_and_gapja": "1391–2050.",
    "solar_terms": "1391–2050 (astronomically computed, any year in range). Dates exact; entry-time minutes within ~±15min."
  },
  "note": "Holiday dates are statutory Korean public holidays."
}