Back to Browse
1gateway South Korea Public Holidays
x402
1gateway South Korea Public Holidays is a paid API for AI agents from 1gateway.dev, paid per call via x402, $0.0027/call, status unknown (last checked 2026-10-10).
Returns South Korea's official public holidays for a given year, sourced from KASI, including substitute and temporary holidays.
Price / call$0.0027
Success—
StatusUnknown
How this service works
1gateway is a pay-per-call API gateway for AI agents and developers: data APIs normalized to clean English JSON, paid per request with USDC on Base via x402 — no signup, no API key. Current coverage: Korean data (real estate trades, weather forecasts, holidays); more APIs and countries are coming.
Output
A JSON object containing the requested year, country (KR), timezone (Asia/Seoul), total holiday count, public holiday count, attribution to KASI, cache metadata, notes (e.g. on temporary holidays), and a list of holiday objects each with date (YYYY-MM-DD), dayOfWeek, nameKo, nameEn, isPublicHoliday (boolean), kind, and kindCode.
Example use cases
Business-day settlement calendar for fintech
“I need the full list of South Korean public holidays for 2025, including substitute holidays, so I can calculate valid settlement days for KRW transactions.”
HR payroll scheduling for Korean workforce
“Can you pull the official Korean national holidays for 2026 so I can set up our payroll system to skip non-working days?”
Cross-border meeting scheduler
“What public holidays does South Korea observe in 2025? I need to avoid scheduling client calls with our Seoul office on those days.”
Technical details
Endpoint
GEThttps://1gateway.dev/v1/calendar/holidays?utm_source=zero.xyzWhen to prefer
Choose this endpoint when you specifically need South Korea's official public holiday list sourced from KASI with Korean and English names, substitute holidays, and kind metadata — ideal for business-day calculations, payroll, settlement calendars, or scheduling agents that must respect Korean statutory non-working days. Prefer this over generic calendar APIs when official government-sourced Korean holiday data and Korean-language names are required.
Side effects
- Year out of range (below 2004 or above 2100) returns a validation error
- Missing required 'year' parameter returns a 400 bad request
- KASI data not yet promulgated for a future year may return an incomplete or empty holiday list
- Payment failure via x402 protocol results in a 402 response before data is returned
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": {
"year": 2026,
"holidays": [
{
"date": "2026-03-01",
"nameEn": "Independence Movement Day",
"nameKo": "삼일절",
"dayOfWeek": "Sunday",
"isPublicHoliday": true
}
]
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"