# Korea Public Holiday Lookup (kr-holiday)

> Korea Public Holiday Lookup (kr-holiday) is a paid API for AI agents from x402-research.kgy5612.workers.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-13).

Returns Korean public holidays as JSON from the official data.go.kr SpcdeInfoService for a given year and optional month.

## Facts

- Endpoint: GET https://x402-research.kgy5612.workers.dev/kr-holiday
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/korea-public-holiday-lookup-kr-holiday-ca30f460
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DJHkkmgvxyFyGMPdD4wG4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability korea-public-holiday-lookup-kr-holiday-ca30f460
```

Example prompt: Can you get me the official list of all Korean public holidays for 2026 from the government data portal? I'd like to see the full year, so don't filter by month.

## When to prefer this

Use this endpoint when you need authoritative, government-sourced Korean public holiday data in JSON format, especially for scheduling, payroll, or calendar applications targeting South Korea. Prefer it over scraping or third-party calendar APIs when official data.go.kr accuracy is required. Ideal for both full-year and month-specific queries.

## Known failure modes

- Missing solYear parameter returns an error or empty result
- Invalid year format (non-4-digit) rejected by schema validation
- Invalid month format (outside 01-12) rejected by schema
- No holidays found for a given month returns empty list
- Payment of 0.03 USDC not completed results in 402 response
- data.go.kr upstream API unavailable causes request failure

## How this service works

Call for Korea public holiday JSON (공휴일 getRestDeInfo). Official data.go.kr SpcdeInfoService. solYear required; solMonth optional.

## Output

A paginated JSON list of Korean public holidays, each entry including the holiday name (in Korean), the solar date, and related metadata from the official SpcdeInfoService. The response reflects official government data for the requested year and optional month.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page_no": {
   "type": "integer",
   "minimum": 1,
   "description": "Page number (default 1)."
  },
  "solYear": {
   "type": "string",
   "pattern": "^\\d{4}$",
   "description": "Required. Solar year YYYY (e.g. \"2026\")."
  },
  "solMonth": {
   "type": "string",
   "pattern": "^(0[1-9]|1[0-2])$",
   "description": "Optional. Solar month MM 01-12. Omit for whole-year listing."
  },
  "num_of_rows": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Rows per page (default 100, max 100)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/korea-public-holiday-lookup-kr-holiday-ca30f460/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-research.kgy5612.workers.dev](https://www.zero.xyz/host/x402-research.kgy5612.workers.dev/llms.txt)