Service
Normalized Korean special-day calendar from KASI SpcdeInfoService: public holidays, national days, anniversaries, 24 solar terms, and traditional days.
99.90%30-day uptimeAvg response178ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-holiday/anniversaries | Lists Korean memorial and commemorative anniversaries for a solar year or month via KASI getAnniversaryInfo. Use when building cultural or civic calendars of observances that are usually NOT automatic days off. Do NOT use for public holidays or payroll closed-day logic — use korea-holiday:public-holidays and filter is_public_institution_holiday instead. Returns ISO dates, official names, kind, remarks when present, and paging totals (total_count, page, limit). Uses an APIFuse-managed data.go.kr service key; the upstream portal quota applies. | |
| POST | /v1/korea-holiday/national-days | Lists the full KASI getHoliDeInfo calendar for a solar year or month: every public holiday (including substitute, election, and temporary holidays) plus statutory national days that are not days off, such as Constitution Day (제헌절). It is a superset of korea-holiday:public-holidays and differs only by those non-rest rows; in years without such rows the two are identical. Use when you need national days that are not days off alongside the holiday calendar. Do NOT use for closed-day decisions — use korea-holiday:public-holidays instead, or filter is_public_institution_holiday here. Returns ISO dates, official names, kind, and is_public_institution_holiday. Uses an APIFuse-managed data.go.kr service key; the upstream portal quota applies. | |
| POST | /v1/korea-holiday/public-holidays | Lists South Korean public institution holidays for a solar year or month via KASI getRestDeInfo, including substitute holidays and election days. Use when checking whether banks, schools, or government offices are closed on a Korean calendar day, or when building a year-wide holiday schedule. Do NOT use for solar terms or for memorial anniversaries that are not days off — use korea-holiday:solar-terms or korea-holiday:anniversaries instead. Lunar-calendar conversion is not supported. Returns ISO dates, official Korean names, kind, is_public_institution_holiday, and the upstream total_count with page and limit. Uses an APIFuse-managed data.go.kr service key; the upstream portal quota applies. |
Issue a sandbox key and make your first reservation.
APIFuse holds the partner credentials. You hold one managed key.
Receive events such as reservation confirmations and delivery updates.
Service outages and gateway errors normalise into one error model.
| POST | /v1/korea-holiday/solar-terms | Lists the 24 solar terms for a solar year or month via KASI get24DivisionsInfo, including the KST event clock time and sun longitude when upstream provides them. Use for traditional seasonal markers such as Ipchun or Dongji in Korean almanac contexts. Do NOT use for public holidays or institution closed days — solar terms are usually not holidays; use korea-holiday:public-holidays instead. Returns ISO dates, names, event_time_kst (HH:MM), and sun_longitude_degrees. Uses an APIFuse-managed data.go.kr service key; the upstream portal quota applies. |
| POST | /v1/korea-holiday/traditional-days | Lists traditional miscellaneous Korean calendar days (잡절) such as Hansik or Dano for a solar year or month via KASI getSundryDayInfo. Use for cultural almanac features that go beyond national holidays. Do NOT use as a closed-day calendar — use korea-holiday:public-holidays for institution holidays instead. Returns ISO dates, official names, kind, and is_public_institution_holiday. Uses an APIFuse-managed data.go.kr service key; the upstream portal quota applies. |
