Korea Payroll & Tax API › annual-leave

South Korea paid annual leave under the Labor Standards Act

South Korea paid annual leave under the Labor Standards Act: days currently available, remaining days, next accrual, and payout value of unused leave.

Price: $0.01 USDC per call over REST (x402 on Base, no API key). MCP: free as annual_leave at https://api.kkuldogu.com/mcp. Basis year: 2026.

Input

Field	Type	Required	Description
`startDate`	string	yes	Hire date (YYYY-MM-DD)
`referenceDate`	string		Date to evaluate; default today (YYYY-MM-DD)
`basis`	hire \| fiscal		Accrual basis: hire-date anniversary or calendar (fiscal) year; default hire
`usedDays`	number		Leave days already used in the current period
`monthlyOrdinaryWage`	number		Monthly ordinary wage, for the payout value (KRW)

Example request

curl -X POST https://api.kkuldogu.com/v1/annual-leave -H "content-type: application/json" \
  -d '{"startDate":"2023-03-02","referenceDate":"2026-10-31","usedDays":4,"monthlyOrdinaryWage":3000000}'

Without payment this returns 402 with x402 payment requirements; an x402 client pays $0.01 USDC and retries.

Example response

{
  "basisYear": 2026,
  "currency": "KRW",
  "disclaimer": "For reference only, not legal or tax advice. Uses official 2026 Korean rates and the same formulas as the kkuldogu.com calculators; actual payroll, NHIS/NPS notices and tax settlement can differ.",
  "source": "https://kkuldogu.com",
  "tool": "annual-leave",
  "input": {
    "startDate": "2023-03-02",
    "referenceDate": "2026-10-31",
    "usedDays": 4,
    "monthlyOrdinaryWage": 3000000
  },
  "result": {
    "availableDays": 16,
    "usedDays": 4,
    "remainingDays": 12,
    "dailyLeaveValue": 114833,
    "unusedLeavePay": 1377990,
    "nextGrant": {
      "date": "2027-03-02",
      "days": 16
    }
  }
}

For reference only, not legal or tax advice. Uses official 2026 Korean rates and the same formulas as the kkuldogu.com calculators; actual payroll, NHIS/NPS notices and tax settlement can differ. · Calculators for people (Korean): kkuldogu.com · API home · llms.txt · OpenAPI