{"uid":"cap_9QYfacxkDGAJWh4dw2A5G","slug":"1gateway-south-korea-public-holidays-c8871d66","name":"1gateway South Korea Public Holidays","description":"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.","url":"https://1gateway.dev/v1/calendar/holidays?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["year"],"properties":{"year":{"type":"integer","maximum":2100,"minimum":2004,"examples":[2026],"description":"Year YYYY (2004–2100)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["year","country","timezone","count","publicHolidayCount","notes","attribution","cache","holidays"],"properties":{"year":{"type":"integer"},"cache":{"type":"string"},"count":{"type":"integer"},"notes":{"type":"array","items":{"type":"string"}},"country":{"type":"string"},"holidays":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"kind":{"type":"string"},"nameEn":{"type":"string"},"nameKo":{"type":"string"},"kindCode":{"type":"string"},"dayOfWeek":{"type":"string"},"isPublicHoliday":{"type":"boolean"}}}},"timezone":{"type":"string"},"attribution":{"type":"string"},"publicHolidayCount":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"year":2026,"holidays":[{"date":"2026-03-01","nameEn":"Independence Movement Day","nameKo":"삼일절","dayOfWeek":"Sunday","isPublicHoliday":true}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0027","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0027/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0027","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0027","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9krVw3MbNJ00xiXiWmcvb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0027","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns South Korea's official public holidays for a given year, sourced from KASI, including substitute and temporary holidays.","exampleAgentPrompt":"What are all the official public holidays in South Korea for 2026, including any substitute holidays?","exampleUseCases":[{"title":"Business-day settlement calendar for fintech","prompt":"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."},{"title":"HR payroll scheduling for Korean workforce","prompt":"Can you pull the official Korean national holidays for 2026 so I can set up our payroll system to skip non-working days?"},{"title":"Cross-border meeting scheduler","prompt":"What public holidays does South Korea observe in 2025? I need to avoid scheduling client calls with our Seoul office on those days."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:34:38.709Z","isFirstParty":false,"canonicalSlug":"1gateway-south-korea-public-holidays-c8871d66"}