Korea Payroll & Tax API › annual-leave-batch

South Korea paid annual leave for up to 100 employees in one call

South Korea paid annual leave for up to 100 employees in one call: days available, used and remaining for each employee and the payout value of unused leave, with company-wide totals. Same calculation as annual-leave.

Price: $0.05 USDC per call over REST (x402 on Base, no API key). MCP: paid-only — the MCP tool returns payment instructions. Basis year: 2026.

Input

Example request

curl -X POST https://api.kkuldogu.com/v1/annual-leave-batch -H "content-type: application/json" \
  -d '{"referenceDate":"2026-12-31","employees":[{"id":"kim","startDate":"2023-03-02","usedDays":4,"monthlyOrdinaryWage":3000000},{"id":"lee","startDate":"2026-03-02","monthlyOrdinaryWage":2500000}]}'

Without payment this returns 402 with x402 payment requirements; an x402 client pays $0.05 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-batch",
  "input": {
    "referenceDate": "2026-12-31",
    "employees": [
      {
        "id": "kim",
        "startDate": "2023-03-02",
        "usedDays": 4,
        "monthlyOrdinaryWage": 3000000
      },
      {
        "id": "lee",
        "startDate": "2026-03-02",
        "monthlyOrdinaryWage": 2500000
      }
    ]
  },
  "result": {
    "headcount": 2,
    "totals": {
      "availableDays": 25,
      "usedDays": 4,
      "remainingDays": 21,
      "unusedLeavePay": 2239234
    },
    "employees": [
      {
        "id": "kim",
        "availableDays": 16,
        "usedDays": 4,
        "remainingDays": 12,
        "dailyLeaveValue": 114833,
        "unusedLeavePay": 1377990,
        "nextGrant": {
          "date": "2027-03-02",
          "days": 16
        }
      },
      {
        "id": "lee",
        "availableDays": 9,
        "usedDays": 0,
        "remainingDays": 9,
        "dailyLeaveValue": 95694,
        "unusedLeavePay": 861244,
        "nextGrant": {
          "date": "2027-01-02",
          "days": 1
        }
      }
    ]
  }
}

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