{"openapi":"3.1.0","info":{"title":"kkuldogu Korea payroll & tax API","version":"1.6.0","description":"South Korea 2026 payroll, tax, labor-law and benefit calculators as JSON. Each POST /v1/* call costs $0.01 USDC (19 higher-value tools cost $0.05-$0.10, see x-payment-info on each operation), paid per request with the x402 protocol on Base (no account or API key): the first request returns 402 with payment requirements, retry with the payment header. The 39 base-price tools are also free over MCP at https://api.kkuldogu.com/mcp. 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."},"servers":[{"url":"https://api.kkuldogu.com"}],"security":[],"externalDocs":{"description":"Human-facing calculators (Korean)","url":"https://kkuldogu.com"},"paths":{"/v1/net-pay":{"post":{"operationId":"net_pay","summary":"South Korea take-home pay for an employee","description":"South Korea take-home pay for an employee: monthly net salary after national pension, health and long-term care insurance, employment insurance, and withheld income tax (2026 NTS simplified withholding table) plus local income tax.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"annualSalary":{"type":"number","minimum":0,"description":"Gross annual salary (KRW)"},"monthlySalary":{"type":"number","minimum":0,"description":"Gross monthly salary; overrides annualSalary (KRW)"},"nonTaxable":{"type":"number","minimum":0,"description":"Monthly non-taxable allowances, e.g. meal allowance; default 200000 (KRW)"},"dependents":{"type":"integer","minimum":1,"maximum":20,"description":"Dependents for withholding, including self; default 1"},"children8to20":{"type":"integer","minimum":0,"maximum":10,"description":"Children aged 8-20 among dependents; default 0"},"severanceIncluded":{"type":"boolean","description":"Annual salary includes severance (divided by 13); default false"}},"additionalProperties":false},"example":{"annualSalary":50000000,"dependents":2,"children8to20":1}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"net-pay","input":{"annualSalary":50000000,"dependents":2,"children8to20":1},"result":{"grossMonthly":4166666,"taxableMonthly":3966666,"netMonthly":3625276,"netAnnual12":43503312,"totalDeductions":541390,"deductions":{"nationalPension":188380,"healthInsurance":142600,"longTermCare":18730,"employmentInsurance":35690,"incomeTax":141810,"localIncomeTax":14180}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/social-insurance":{"post":{"operationId":"social_insurance","summary":"South Korea four major social insurances (national pension, health, long-term care, employment) for a monthly wage","description":"South Korea four major social insurances (national pension, health, long-term care, employment) for a monthly wage: employee deductions and employer contributions at 2026 rates.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"monthlyPay":{"type":"number","minimum":0,"description":"Gross monthly pay (KRW)"},"nonTaxable":{"type":"number","minimum":0,"description":"Monthly non-taxable allowances; default 200000 (KRW)"},"employerSize":{"type":"string","enum":["under150","150plus_priority","150to999","1000plus"],"description":"Employer headcount bracket for the employer employment-insurance rate; default under150"}},"required":["monthlyPay"],"additionalProperties":false},"example":{"monthlyPay":3500000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"social-insurance","input":{"monthlyPay":3500000},"result":{"insurableMonthly":3300000,"employeeTotal":320660,"employerTotal":328910,"payAfterInsurance":3179340,"employee":{"nationalPension":156750,"healthInsurance":118630,"longTermCare":15580,"employmentInsurance":29700},"employer":{"nationalPension":156750,"healthInsurance":118630,"longTermCare":15580,"employmentInsurance":37950}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/severance-pay":{"post":{"operationId":"severance_pay","summary":"South Korea statutory severance pay (toejikgeum)","description":"South Korea statutory severance pay (toejikgeum): 30 days of average wage per year of service, with retirement income tax, from hire date, last working day and last 3 months of pay. Pass monthlyOrdinaryWage to apply the legal rule that the ordinary wage replaces a lower average wage (Labor Standards Act art. 2(2)); without it only the average wage is used. Rounding follows the Ministry of Employment and Labor severance calculator.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Hire date (YYYY-MM-DD)"},"lastWorkDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Last working day; default today (YYYY-MM-DD)"},"monthlyPay":{"type":"number","minimum":0,"description":"Average monthly pay for the last 3 months (KRW)"},"annualBonus":{"type":"number","minimum":0,"description":"Bonuses paid in the last 12 months (KRW)"},"annualLeavePay":{"type":"number","minimum":0,"description":"Annual-leave allowance paid in the last 12 months (KRW)"},"monthlyOrdinaryWage":{"type":"number","minimum":0,"description":"Monthly ordinary wage (base pay + fixed allowances). If its daily amount (÷209×8) exceeds the daily average wage, severance is computed from it (KRW)"}},"required":["startDate","monthlyPay"],"additionalProperties":false},"example":{"startDate":"2021-03-02","lastWorkDate":"2026-10-31","monthlyPay":3500000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"severance-pay","input":{"startDate":"2021-03-02","lastWorkDate":"2026-10-31","monthlyPay":3500000},"result":{"eligible":true,"daysEmployed":2070,"averageDailyWage":114130,"averageDailyWageExact":114130.44,"severancePayGross":19417809,"tax":222220,"severancePayNet":19195589,"taxableServiceYears":6,"ordinaryWageCompared":false,"ordinaryWageApplied":false,"dailyOrdinaryWage":null,"eligibleFrom":null}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/retirement-income-tax":{"post":{"operationId":"retirement_income_tax","summary":"South Korea retirement income tax on a severance payment","description":"South Korea retirement income tax on a severance payment: service-year deduction, converted-pay deduction, national and local tax, and the reduced tax if received as an IRP pension.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"severancePay":{"type":"number","minimum":0,"description":"Severance pay before tax (KRW)"},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Hire date (YYYY-MM-DD)"},"lastWorkDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Last working day; default today (YYYY-MM-DD)"}},"required":["severancePay","startDate"],"additionalProperties":false},"example":{"severancePay":30000000,"startDate":"2018-03-02","lastWorkDate":"2026-10-31"}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"retirement-income-tax","input":{"severancePay":30000000,"startDate":"2018-03-02","lastWorkDate":"2026-10-31"},"result":{"severancePay":30000000,"taxableServiceYears":9,"retirementIncomeTax":264000,"localIncomeTax":26400,"totalTax":290400,"netSeverance":29709600,"effectiveRatePct":1,"taxIfPaidAsIrpPension10y":203280,"breakdown":{"serviceYearDeduction":13000000,"convertedPay":22666666.666666668,"convertedPayDeduction":16800000,"taxBase":5866666.666666668,"convertedTax":352000.00000000006}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/annual-leave":{"post":{"operationId":"annual_leave","summary":"South Korea paid annual leave under the Labor Standards Act","description":"South Korea paid annual leave under the Labor Standards Act: days currently available, remaining days, next accrual, and payout value of unused leave.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Hire date (YYYY-MM-DD)"},"referenceDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date to evaluate; default today (YYYY-MM-DD)"},"basis":{"type":"string","enum":["hire","fiscal"],"description":"Accrual basis: hire-date anniversary or calendar (fiscal) year; default hire"},"usedDays":{"type":"number","minimum":0,"description":"Leave days already used in the current period"},"monthlyOrdinaryWage":{"type":"number","minimum":0,"description":"Monthly ordinary wage, for the payout value (KRW)"}},"required":["startDate"],"additionalProperties":false},"example":{"startDate":"2023-03-02","referenceDate":"2026-10-31","usedDays":4,"monthlyOrdinaryWage":3000000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/unemployment-benefit":{"post":{"operationId":"unemployment_benefit","summary":"South Korea unemployment benefit (job-seeking allowance, silup geupyeo)","description":"South Korea unemployment benefit (job-seeking allowance, silup geupyeo): daily amount with 2026 cap and floor, number of benefit days, and total.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"lastWorkDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Last working day; default today (YYYY-MM-DD)"},"age":{"type":"integer","minimum":15,"maximum":100,"description":"Age at separation"},"insuredYears":{"type":"number","minimum":0,"description":"Years insured under employment insurance"},"monthlyPay":{"type":"number","minimum":0,"description":"Average monthly pay for the last 3 months (KRW)"},"dailyContractHours":{"type":"integer","minimum":1,"maximum":8,"description":"Contracted hours per day, for the floor; default 8"},"disabled":{"type":"boolean","description":"Registered disability; default false"}},"required":["age","insuredYears","monthlyPay"],"additionalProperties":false},"example":{"lastWorkDate":"2026-10-31","age":35,"insuredYears":4,"monthlyPay":3200000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"unemployment-benefit","input":{"lastWorkDate":"2026-10-31","age":35,"insuredYears":4,"monthlyPay":3200000},"result":{"dailyBenefit":66048,"benefitDays":180,"totalBenefit":11888640,"averageDailyWage":104348,"dailyCap":68100,"dailyFloor":66048,"capApplied":false,"floorApplied":true}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/parental-leave-benefit":{"post":{"operationId":"parental_leave_benefit","summary":"South Korea parental leave benefit from employment insurance, month by month with caps, including the 6+6 both-parents scheme and single parents","description":"South Korea parental leave benefit from employment insurance, month by month with caps, including the 6+6 both-parents scheme and single parents.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"monthlyOrdinaryWage":{"type":"number","minimum":0,"description":"Monthly ordinary wage (KRW)"},"months":{"type":"integer","minimum":1,"maximum":18,"description":"Months of leave; default 12"},"mode":{"type":"string","enum":["normal","both_parents","single_parent"],"description":"normal, both_parents (6+6 scheme, child under 18 months) or single_parent; default normal"},"spouseMonthlyOrdinaryWage":{"type":"number","minimum":0,"description":"Spouse's monthly ordinary wage, both_parents only (KRW)"},"spouseMonths":{"type":"integer","minimum":1,"maximum":18,"description":"Spouse leave months, both_parents only; default 6"}},"required":["monthlyOrdinaryWage"],"additionalProperties":false},"example":{"monthlyOrdinaryWage":3500000,"months":12}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"parental-leave-benefit","input":{"monthlyOrdinaryWage":3500000,"months":12},"result":{"total":23100000,"self":{"monthly":[{"month":1,"amount":2500000,"cap":2500000},{"month":2,"amount":2500000,"cap":2500000},{"month":3,"amount":2500000,"cap":2500000},{"month":4,"amount":2000000,"cap":2000000},{"month":5,"amount":2000000,"cap":2000000},{"month":6,"amount":2000000,"cap":2000000},{"month":7,"amount":1600000,"cap":1600000},{"month":8,"amount":1600000,"cap":1600000},{"month":9,"amount":1600000,"cap":1600000},{"month":10,"amount":1600000,"cap":1600000},{"month":11,"amount":1600000,"cap":1600000},{"month":12,"amount":1600000,"cap":1600000}],"total":23100000}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/weekly-holiday-pay":{"post":{"operationId":"weekly_holiday_pay","summary":"South Korea weekly holiday pay (juhyu sudang)","description":"South Korea weekly holiday pay (juhyu sudang): the paid weekly rest allowance owed to workers contracted for 15+ hours a week, with weekly and monthly pay including it.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"hourlyWage":{"type":"number","minimum":0,"description":"Hourly wage (KRW)"},"weeklyHours":{"type":"number","minimum":0,"maximum":68,"description":"Contracted hours per week"}},"required":["hourlyWage","weeklyHours"],"additionalProperties":false},"example":{"hourlyWage":10320,"weeklyHours":20}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"weekly-holiday-pay","input":{"hourlyWage":10320,"weeklyHours":20},"result":{"eligible":true,"weeklyHolidayPay":41280,"holidayHours":4,"weeklyPay":247680,"monthlyPay":1076229,"effectiveHourlyWage":12384,"minimumWage":10320,"belowMinimumWage":false}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/wage-conversion":{"post":{"operationId":"wage_conversion","summary":"Convert between hourly wage, monthly salary and annual salary the South Korean way (monthly hours include paid weekly holiday hours, 209 for a 40-hour week), with a 2026 minimum wage check","description":"Convert between hourly wage, monthly salary and annual salary the South Korean way (monthly hours include paid weekly holiday hours, 209 for a 40-hour week), with a 2026 minimum wage check.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"amount":{"type":"number","minimum":0,"description":"Wage amount in the given unit (KRW)"},"unit":{"type":"string","enum":["hourly","monthly","annual"],"description":"Unit of amount; default hourly"},"weeklyHours":{"type":"number","minimum":1,"maximum":52,"description":"Contracted hours per week; default 40"}},"required":["amount"],"additionalProperties":false},"example":{"amount":3000000,"unit":"monthly"}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"wage-conversion","input":{"amount":3000000,"unit":"monthly"},"result":{"monthlyHours":209,"weeklyHolidayHours":8,"hourly":14354,"daily8h":114833,"weekly":688995,"monthly":3000000,"annual":36000000,"minimumWage":10320,"belowMinimumWage":false}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/minimum-wage-check":{"post":{"operationId":"minimum_wage_check","summary":"Check a South Korean monthly wage against the 2026 minimum wage (KRW 10,320/hour)","description":"Check a South Korean monthly wage against the 2026 minimum wage (KRW 10,320/hour): counts base pay, monthly regular bonus and cash welfare allowances, supports the 90% probation rate.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"monthlyBasePay":{"type":"number","minimum":0,"description":"Monthly base pay (KRW)"},"monthlyBonus":{"type":"number","minimum":0,"description":"Regular bonus paid every month (KRW)"},"monthlyWelfare":{"type":"number","minimum":0,"description":"Monthly cash welfare allowances such as meals or transport (KRW)"},"weeklyHours":{"type":"number","minimum":1,"maximum":40,"description":"Contracted hours per week; default 40"},"probation":{"type":"boolean","description":"Probation within first 3 months of a 1+ year contract (90% rate); default false"}},"required":["monthlyBasePay"],"additionalProperties":false},"example":{"monthlyBasePay":2000000,"monthlyWelfare":200000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"minimum-wage-check","input":{"monthlyBasePay":2000000,"monthlyWelfare":200000},"result":{"compliant":true,"hourlyEquivalent":10526,"minimumHourly":10320,"countedMonthlyPay":2200000,"monthlyHours":209,"minimumMonthlyPay":2156880,"monthlySurplus":43120,"monthlyShortfall":0}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/part-time-pay":{"post":{"operationId":"part_time_pay","summary":"South Korea part-time (alba) monthly pay from an hourly wage and schedule, including weekly holiday pay, after either 3","description":"South Korea part-time (alba) monthly pay from an hourly wage and schedule, including weekly holiday pay, after either 3.3% withholding or the four social insurances plus income tax.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"hourlyWage":{"type":"number","minimum":0,"description":"Hourly wage (KRW)"},"hoursPerDay":{"type":"number","minimum":0,"maximum":24,"description":"Hours worked per day"},"daysPerWeek":{"type":"number","minimum":1,"maximum":7,"description":"Days worked per week"},"deduction":{"type":"string","enum":["none","freelancer_3_3","social_insurance"],"description":"none, freelancer_3_3 (3.3% withholding) or social_insurance (four insurances + income tax); default none"}},"required":["hourlyWage","hoursPerDay","daysPerWeek"],"additionalProperties":false},"example":{"hourlyWage":10320,"hoursPerDay":5,"daysPerWeek":5,"deduction":"freelancer_3_3"}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"part-time-pay","input":{"hourlyWage":10320,"hoursPerDay":5,"daysPerWeek":5,"deduction":"freelancer_3_3"},"result":{"netMonthly":1300906,"grossMonthly":1345286,"weeklyHolidayPayMonthly":224214,"weeklyPay":309600,"deductions":44380,"weeklyHours":25,"weeklyHolidayEligible":true,"belowMinimumWage":false}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/overtime-pay":{"post":{"operationId":"overtime_pay","summary":"South Korea overtime, night and holiday work premiums under the Labor Standards Act (1","description":"South Korea overtime, night and holiday work premiums under the Labor Standards Act (1.5x overtime, +0.5x night, 1.5x/2x holiday); workplaces with fewer than 5 employees get no premium.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"wage":{"type":"number","minimum":0,"description":"Hourly wage, or monthly ordinary wage when unit is monthly (KRW)"},"unit":{"type":"string","enum":["hourly","monthly"],"description":"hourly, or monthly (divided by 209 hours); default hourly"},"overtimeHours":{"type":"number","minimum":0,"description":"Overtime hours"},"nightHours":{"type":"number","minimum":0,"description":"Night hours (22:00-06:00); also enter them as overtime if they overlap"},"holidayHours":{"type":"number","minimum":0,"description":"Holiday work hours up to 8 per day"},"holidayHoursOver8":{"type":"number","minimum":0,"description":"Holiday work hours beyond 8 per day"},"fiveOrMoreEmployees":{"type":"boolean","description":"Workplace has 5 or more employees; default true"}},"required":["wage"],"additionalProperties":false},"example":{"wage":12000,"overtimeHours":10,"nightHours":4,"holidayHours":8}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"overtime-pay","input":{"wage":12000,"overtimeHours":10,"nightHours":4,"holidayHours":8},"result":{"total":348000,"hourlyBase":12000,"overtime":180000,"nightPremium":24000,"holiday":144000,"holidayOver8":0,"multipliers":{"overtime":1.5,"nightPremium":0.5,"holiday":1.5,"holidayOver8":2}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/ordinary-wage":{"post":{"operationId":"ordinary_wage","summary":"South Korea ordinary wage (tongsang imgeum)","description":"South Korea ordinary wage (tongsang imgeum): hourly and daily ordinary wage from base pay, fixed allowances and regular bonuses, the basis for overtime, unused leave and dismissal notice pay.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"monthlyBasePay":{"type":"number","minimum":0,"description":"Monthly base pay (KRW)"},"monthlyFixedAllowances":{"type":"number","minimum":0,"description":"Fixed monthly allowances paid to everyone regularly (KRW)"},"annualRegularBonus":{"type":"number","minimum":0,"description":"Regular bonuses per year (KRW)"},"weeklyHours":{"type":"number","minimum":1,"maximum":40,"description":"Contracted hours per week; default 40"}},"required":["monthlyBasePay"],"additionalProperties":false},"example":{"monthlyBasePay":2800000,"monthlyFixedAllowances":300000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"ordinary-wage","input":{"monthlyBasePay":2800000,"monthlyFixedAllowances":300000},"result":{"hourly":14833,"monthly":3100000,"monthlyHours":209,"dailyHours":8,"daily":118660,"overtimePerHour":22249,"unusedLeavePerDay":118660,"dismissalNoticePay30d":3559809,"belowMinimumWage":false}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/average-wage":{"post":{"operationId":"average_wage","summary":"South Korea average wage (pyeonggyun imgeum)","description":"South Korea average wage (pyeonggyun imgeum): daily average over the 3 months before the last working day, the basis for severance pay and unemployment benefit; falls back to the ordinary wage when that is higher.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"lastWorkDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Last working day; default today (YYYY-MM-DD)"},"monthlyPay":{"type":"number","minimum":0,"description":"Monthly pay over the last 3 months (KRW)"},"monthlyOrdinaryWage":{"type":"number","minimum":0,"description":"Monthly ordinary wage (base pay + fixed allowances). If its daily amount (÷209×8) exceeds the daily average wage, severance is computed from it (KRW)"},"annualBonus":{"type":"number","minimum":0,"description":"Bonuses paid in the last 12 months (KRW)"},"annualLeavePay":{"type":"number","minimum":0,"description":"Annual-leave allowance paid in the last 12 months (KRW)"}},"required":["monthlyPay"],"additionalProperties":false},"example":{"lastWorkDate":"2026-10-31","monthlyPay":3500000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"average-wage","input":{"lastWorkDate":"2026-10-31","monthlyPay":3500000},"result":{"averageDailyWage":114130,"periodStart":"2026-08-01","periodEnd":"2026-10-31","periodDays":92,"threeMonthPay":10500000,"bonusAndLeavePortion":0,"ordinaryWageUsed":false,"severancePerYear":3423913,"unemploymentDailyBenefit":68100}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/gross-from-net":{"post":{"operationId":"gross_from_net","summary":"Reverse South Korea take-home pay","description":"Reverse South Korea take-home pay: the gross monthly and annual salary needed to reach a target monthly net pay after 2026 social insurance and withheld income tax.","x-payment-info":{"protocol":"x402","price":"$0.05 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"targetNetMonthly":{"type":"number","minimum":0,"maximum":150000000,"description":"Desired monthly take-home pay (KRW)"},"nonTaxable":{"type":"number","minimum":0,"description":"Monthly non-taxable allowances; default 200000 (KRW)"},"dependents":{"type":"integer","minimum":1,"maximum":20,"description":"Dependents including self; default 1"},"children8to20":{"type":"integer","minimum":0,"maximum":10,"description":"Children aged 8-20; default 0"},"severanceIncluded":{"type":"boolean","description":"Quote the annual salary with severance included (x13); default false"}},"required":["targetNetMonthly"],"additionalProperties":false},"example":{"targetNetMonthly":3000000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"gross-from-net","input":{"targetNetMonthly":3000000},"result":{"requiredAnnualSalary":40956000,"grossMonthly":3413000,"actualNetMonthly":3000210,"socialInsurance":312190,"incomeTaxAndLocal":100600}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/freelancer-withholding":{"post":{"operationId":"freelancer_withholding","summary":"South Korea 3","description":"South Korea 3.3% business-income withholding for freelancers (3% income tax + 0.3% local tax), in either direction: net from gross, or the gross to invoice for a target net.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"amount":{"type":"number","minimum":0,"description":"Gross payment, or desired net when direction is net_to_gross (KRW)"},"direction":{"type":"string","enum":["gross_to_net","net_to_gross"],"description":"default gross_to_net"}},"required":["amount"],"additionalProperties":false},"example":{"amount":1000000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"freelancer-withholding","input":{"amount":1000000},"result":{"gross":1000000,"incomeTax":30000,"localIncomeTax":3000,"net":967000}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/daily-worker-tax":{"post":{"operationId":"daily_worker_tax","summary":"South Korea daily (day-labor) worker tax","description":"South Korea daily (day-labor) worker tax: income tax after the KRW 150,000 daily deduction and 55% credit, local tax and employment insurance, for wages paid daily or in one lump sum.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"dailyWage":{"type":"number","minimum":0,"description":"Daily wage (KRW)"},"days":{"type":"integer","minimum":1,"maximum":31,"description":"Days worked; default 1"},"paidDaily":{"type":"boolean","description":"Paid each day (true) or in one lump sum (false); default true"},"employmentInsurance":{"type":"boolean","description":"Deduct employment insurance 0.9%; default true"}},"required":["dailyWage"],"additionalProperties":false},"example":{"dailyWage":200000,"days":10}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"daily-worker-tax","input":{"dailyWage":200000,"days":10},"result":{"net":1967200,"gross":2000000,"incomeTax":13500,"localIncomeTax":1300,"employmentInsurance":18000,"netPerDay":196720}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/other-income-tax":{"post":{"operationId":"other_income_tax","summary":"South Korea other-income (gita sodeuk) withholding of 22% on income after deemed expenses, e","description":"South Korea other-income (gita sodeuk) withholding of 22% on income after deemed expenses, e.g. lecture fees, manuscript fees and prizes, with the KRW 50,000 exemption threshold.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"amount":{"type":"number","minimum":0,"description":"Gross payment (KRW)"},"expenseRate":{"type":"number","enum":[0.6,0.8,0],"description":"Deemed expense rate: 0.6 (lectures, manuscripts, advisory), 0.8 (public-interest prizes) or 0; default 0.6"}},"required":["amount"],"additionalProperties":false},"example":{"amount":500000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"other-income-tax","input":{"amount":500000},"result":{"net":456000,"taxableIncome":200000,"incomeTax":40000,"localIncomeTax":4000,"effectiveRatePct":8.8}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/dismissal-notice-pay":{"post":{"operationId":"dismissal_notice_pay","summary":"South Korea dismissal notice allowance","description":"South Korea dismissal notice allowance: 30 days of ordinary wage owed when an employer gives less than 30 days notice (not owed for under 3 months of service).","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"noticeDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date notice was given (YYYY-MM-DD)"},"dismissalDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Dismissal date (day after the last working day) (YYYY-MM-DD)"},"monthlyOrdinaryWage":{"type":"number","minimum":0,"description":"Monthly ordinary wage (KRW)"},"dailyHours":{"type":"number","minimum":1,"maximum":8,"description":"Contracted hours per day; default 8"},"under3Months":{"type":"boolean","description":"Employed for less than 3 months; default false"}},"required":["noticeDate","dismissalDate","monthlyOrdinaryWage"],"additionalProperties":false},"example":{"noticeDate":"2026-11-10","dismissalDate":"2026-11-20","monthlyOrdinaryWage":3000000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"dismissal-notice-pay","input":{"noticeDate":"2026-11-10","dismissalDate":"2026-11-20","monthlyOrdinaryWage":3000000},"result":{"required":true,"pay":3444976,"noticeDays":10,"dailyOrdinaryWage":114833,"thirtyDayAmount":3444976}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/shutdown-allowance":{"post":{"operationId":"shutdown_allowance","summary":"South Korea business shutdown allowance (hyueop sudang)","description":"South Korea business shutdown allowance (hyueop sudang): 70% of average wage, or the ordinary wage if that is lower, for days the employer suspends work (5+ employee workplaces).","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"monthlyAverageWage":{"type":"number","minimum":0,"description":"Monthly average wage (KRW)"},"monthlyOrdinaryWage":{"type":"number","minimum":0,"description":"Monthly ordinary wage (KRW)"},"days":{"type":"number","minimum":1,"maximum":365,"description":"Shutdown days"},"fiveOrMoreEmployees":{"type":"boolean","description":"Workplace has 5 or more employees; default true"}},"required":["monthlyAverageWage","monthlyOrdinaryWage","days"],"additionalProperties":false},"example":{"monthlyAverageWage":3200000,"monthlyOrdinaryWage":2900000,"days":30}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"shutdown-allowance","input":{"monthlyAverageWage":3200000,"monthlyOrdinaryWage":2900000,"days":30},"result":{"total":2209315,"dailyAverageWage":105205,"seventyPctDaily":73644,"dailyOrdinaryWage":111005,"appliedDaily":73644,"ordinaryWageApplied":false}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/maternity-leave-pay":{"post":{"operationId":"maternity_leave_pay","summary":"South Korea maternity leave pay for 90 days (120 for multiple births)","description":"South Korea maternity leave pay for 90 days (120 for multiple births): split between employer and employment insurance, with the 2026 monthly cap of KRW 2.2 million.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"monthlyOrdinaryWage":{"type":"number","minimum":0,"description":"Monthly ordinary wage (KRW)"},"multipleBirth":{"type":"boolean","description":"Twins or more (120 days); default false"},"priorityCompany":{"type":"boolean","description":"Employer is a priority-support (small/medium) company; default true"}},"required":["monthlyOrdinaryWage"],"additionalProperties":false},"example":{"monthlyOrdinaryWage":3500000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"maternity-leave-pay","input":{"monthlyOrdinaryWage":3500000},"result":{"leaveDays":90,"employerPaidDays":60,"total":9200000,"employerPaidPeriod":7000000,"remainingPeriod":2200000,"fromEmploymentInsurance":6600000,"fromEmployer":2600000}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/paternity-leave-pay":{"post":{"operationId":"paternity_leave_pay","summary":"South Korea spouse (paternity) childbirth leave pay for the 20 paid days, and how much employment insurance covers at priority-support companies","description":"South Korea spouse (paternity) childbirth leave pay for the 20 paid days, and how much employment insurance covers at priority-support companies.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"monthlyOrdinaryWage":{"type":"number","minimum":0,"description":"Monthly ordinary wage (KRW)"},"dailyHours":{"type":"number","minimum":1,"maximum":8,"description":"Contracted hours per day; default 8"},"priorityCompany":{"type":"boolean","description":"Employer is a priority-support (small/medium) company; default true"}},"required":["monthlyOrdinaryWage"],"additionalProperties":false},"example":{"monthlyOrdinaryWage":4000000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"paternity-leave-pay","input":{"monthlyOrdinaryWage":4000000},"result":{"leaveDays":20,"total":3062201,"dailyOrdinaryWage":153110,"fromEmploymentInsurance":1684210,"fromEmployer":1377991}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/reduced-hours-childcare-benefit":{"post":{"operationId":"reduced_hours_childcare_benefit","summary":"South Korea reduced working hours for childcare benefit","description":"South Korea reduced working hours for childcare benefit: monthly employment-insurance top-up (first 10 reduced hours at 100%, rest at 80%, with caps) plus the reduced employer pay.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"monthlyOrdinaryWage":{"type":"number","minimum":0,"description":"Monthly ordinary wage before the reduction (KRW)"},"weeklyHoursBefore":{"type":"number","minimum":15,"maximum":40,"description":"Weekly hours before; default 40"},"weeklyHoursAfter":{"type":"number","minimum":15,"maximum":35,"description":"Weekly hours after the reduction"},"months":{"type":"integer","minimum":1,"maximum":36,"description":"Months of reduced hours, for the total; default 1"}},"required":["monthlyOrdinaryWage","weeklyHoursAfter"],"additionalProperties":false},"example":{"monthlyOrdinaryWage":3500000,"weeklyHoursAfter":30,"months":12}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"reduced-hours-childcare-benefit","input":{"monthlyOrdinaryWage":3500000,"weeklyHoursAfter":30,"months":12},"result":{"monthlyTotal":3250000,"employerPay":2625000,"benefit":625000,"first10HoursPortion":625000,"remainingHoursPortion":0,"reducedHours":10,"pctOfOriginalPay":92.9,"benefitTotal":7500000}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/year-end-tax-settlement":{"post":{"operationId":"year_end_tax_settlement","summary":"South Korea year-end tax settlement (yeonmal jeongsan) estimate for employees","description":"South Korea year-end tax settlement (yeonmal jeongsan) estimate for employees: refund or additional tax from gross salary, dependents, card spending and the main deductions and credits, choosing itemized vs standard credit.","x-payment-info":{"protocol":"x402","price":"$0.10 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","minimum":0,"description":"Annual gross salary excluding non-taxable pay (KRW)"},"taxWithheld":{"type":"number","minimum":0,"description":"Income tax already withheld this year; estimated from the withholding table if omitted (KRW)"},"dependents":{"type":"integer","minimum":1,"maximum":20,"description":"Persons for the basic deduction, including self; default 1"},"children":{"type":"integer","minimum":0,"maximum":10,"description":"Children among dependents"},"children8to20":{"type":"integer","minimum":0,"maximum":10,"description":"Children aged 8 or older (child tax credit)"},"birthOrder":{"type":"number","enum":[0,1,2,3],"description":"Birth/adoption this year: 0 none, 1 first, 2 second, 3 third or later"},"seniors70":{"type":"integer","minimum":0,"maximum":10,"description":"Dependents aged 70+"},"disabled":{"type":"integer","minimum":0,"maximum":10,"description":"Disabled dependents including self"},"marriedThisYear":{"type":"boolean","description":"Marriage registered this year (KRW 500,000 credit)"},"creditCard":{"type":"number","minimum":0,"description":"Credit card spending (KRW)"},"debitCash":{"type":"number","minimum":0,"description":"Debit card and cash-receipt spending (KRW)"},"traditionalMarketTransit":{"type":"number","minimum":0,"description":"Traditional market and public transport spending (KRW)"},"cultureSports":{"type":"number","minimum":0,"description":"Books, performances, cinema, gym spending (salary up to 70M) (KRW)"},"insurancePremiums":{"type":"number","minimum":0,"description":"Protection-type insurance premiums (KRW)"},"medical":{"type":"number","minimum":0,"description":"Medical expenses (KRW)"},"education":{"type":"number","minimum":0,"description":"Education expenses (KRW)"},"donations":{"type":"number","minimum":0,"description":"Donations (KRW)"},"pensionSavings":{"type":"number","minimum":0,"description":"Pension savings contributions (KRW)"},"irp":{"type":"number","minimum":0,"description":"IRP contributions (KRW)"},"annualRent":{"type":"number","minimum":0,"description":"Monthly rent paid over the year (homeless householder) (KRW)"},"housingSubscription":{"type":"number","minimum":0,"description":"Housing subscription savings contributions (KRW)"}},"required":["grossSalary"],"additionalProperties":false},"example":{"grossSalary":50000000,"creditCard":15000000,"debitCash":5000000,"insurancePremiums":1000000,"medical":500000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"year-end-tax-settlement","input":{"grossSalary":50000000,"creditCard":15000000,"debitCash":5000000,"insurancePremiums":1000000,"medical":500000},"result":{"outcome":"refund","amount":242350,"finalIncomeTax":2387520,"localIncomeTax":238750,"incomeTaxAlreadyWithheld":2607840,"withheldIsEstimate":true,"effectiveRatePct":5.3,"method":"itemized_special_deductions","breakdown":{"earnedIncomeDeduction":12250000,"earnedIncome":37750000,"personalDeduction":1500000,"nationalPension":2374560,"healthAndEmploymentInsurance":2483640,"housingSubscriptionDeduction":0,"cardDeduction":1875000,"taxBase":29516800,"calculatedTax":3167520,"earnedIncomeTaxCredit":660000,"childBirthMarriageCredit":0,"pensionCredit":0,"specialTaxCredits":120000,"rentCredit":0,"standardTaxCredit":0}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/monthly-rent-tax-credit":{"post":{"operationId":"monthly_rent_tax_credit","summary":"South Korea monthly rent (wolse) tax credit at year-end settlement","description":"South Korea monthly rent (wolse) tax credit at year-end settlement: 17% or 15% of up to KRW 10 million rent for homeless tenants earning up to KRW 80 million.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","minimum":0,"description":"Annual gross salary (KRW)"},"monthlyRent":{"type":"number","minimum":0,"description":"Monthly rent excluding maintenance fees (KRW)"},"months":{"type":"integer","minimum":1,"maximum":12,"description":"Months paid this year; default 12"},"eligibleTenant":{"type":"boolean","description":"Homeless householder (or member) with resident registration at the address; default true"}},"required":["grossSalary","monthlyRent"],"additionalProperties":false},"example":{"grossSalary":40000000,"monthlyRent":600000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"monthly-rent-tax-credit","input":{"grossSalary":40000000,"monthlyRent":600000},"result":{"credit":1224000,"eligible":true,"annualRent":7200000,"eligibleRent":7200000,"ratePct":17}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/card-income-deduction":{"post":{"operationId":"card_income_deduction","summary":"South Korea credit card income deduction for year-end settlement","description":"South Korea credit card income deduction for year-end settlement: deduction from credit, debit/cash, traditional market/transit and culture spending above 25% of salary, with limits and estimated tax saved.","x-payment-info":{"protocol":"x402","price":"$0.05 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","minimum":0,"description":"Annual gross salary (KRW)"},"children":{"type":"integer","minimum":0,"maximum":10,"description":"Number of children (raises the limit)"},"creditCard":{"type":"number","minimum":0,"description":"Credit card spending (KRW)"},"debitCash":{"type":"number","minimum":0,"description":"Debit card and cash-receipt spending (KRW)"},"traditionalMarketTransit":{"type":"number","minimum":0,"description":"Traditional market and public transport spending (KRW)"},"cultureSports":{"type":"number","minimum":0,"description":"Books, performances, cinema, gym spending (KRW)"}},"required":["grossSalary"],"additionalProperties":false},"example":{"grossSalary":50000000,"creditCard":15000000,"debitCash":5000000,"traditionalMarketTransit":800000,"cultureSports":300000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"card-income-deduction","input":{"grossSalary":50000000,"creditCard":15000000,"debitCash":5000000,"traditionalMarketTransit":800000,"cultureSports":300000},"result":{"deduction":2285000,"estimatedTaxSaving":377025,"minimumSpend":12500000,"totalSpend":21100000,"baseLimit":3000000,"extraLimitUsed":0}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/pension-savings-tax-credit":{"post":{"operationId":"pension_savings_tax_credit","summary":"South Korea pension savings and IRP tax credit","description":"South Korea pension savings and IRP tax credit: 16.5% or 13.2% (incl. local tax) of contributions up to KRW 9 million, and the extra refund from filling the remaining limit.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"grossSalary":{"type":"number","minimum":0,"description":"Annual gross salary (KRW)"},"pensionSavings":{"type":"number","minimum":0,"description":"Pension savings contributions this year (KRW)"},"irp":{"type":"number","minimum":0,"description":"IRP contributions this year (KRW)"}},"required":["grossSalary"],"additionalProperties":false},"example":{"grossSalary":50000000,"pensionSavings":4000000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"pension-savings-tax-credit","input":{"grossSalary":50000000,"pensionSavings":4000000},"result":{"credit":660000,"ratePct":16.5,"eligibleContribution":4000000,"remainingLimit":5000000,"extraCreditIfMaxed":825000}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/bonus-tax":{"post":{"operationId":"bonus_tax","summary":"South Korea tax withheld on a bonus or incentive payment","description":"South Korea tax withheld on a bonus or incentive payment: income tax by the simplified-table bonus method over the payment period, local tax and employment insurance, and the net bonus.","x-payment-info":{"protocol":"x402","price":"$0.05 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"bonus":{"type":"number","minimum":0,"description":"Bonus amount (KRW)"},"monthlySalary":{"type":"number","minimum":0,"description":"Usual monthly taxable salary (KRW)"},"periodMonths":{"type":"integer","minimum":1,"maximum":12,"description":"Months the bonus covers (1, 3 quarterly, 6 half-year, 12 annual); default 1"},"dependents":{"type":"integer","minimum":1,"maximum":20,"description":"Dependents including self; default 1"},"children8to20":{"type":"integer","minimum":0,"maximum":10,"description":"Children aged 8-20; default 0"}},"required":["bonus","monthlySalary"],"additionalProperties":false},"example":{"bonus":5000000,"monthlySalary":3800000,"periodMonths":12}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"bonus-tax","input":{"bonus":5000000,"monthlySalary":3800000,"periodMonths":12},"result":{"net":4250120,"bonus":5000000,"incomeTax":640800,"localIncomeTax":64080,"employmentInsurance":45000,"deductionRatePct":15}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/vat":{"post":{"operationId":"vat","summary":"South Korea 10% VAT","description":"South Korea 10% VAT: split a VAT-inclusive total into supply amount and VAT, or add VAT to a supply amount, with Korean rounding.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"amount":{"type":"number","minimum":0,"description":"Supply amount, or VAT-inclusive total when mode is total (KRW)"},"mode":{"type":"string","enum":["supply","total"],"description":"amount is the supply amount (default) or the VAT-inclusive total"}},"required":["amount"],"additionalProperties":false},"example":{"amount":1100000,"mode":"total"}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"vat","input":{"amount":1100000,"mode":"total"},"result":{"supplyAmount":1000000,"vat":100000,"total":1100000}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/brokerage-fee":{"post":{"operationId":"brokerage_fee","summary":"South Korea real-estate brokerage fee ceiling (bokbi) for a sale, jeonse or monthly-rent lease of a house or officetel","description":"South Korea real-estate brokerage fee ceiling (bokbi) for a sale, jeonse or monthly-rent lease of a house or officetel: statutory rate bracket, fee cap and VAT.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"transaction":{"type":"string","enum":["sale","jeonse","wolse"],"description":"sale, jeonse (lump-sum deposit lease) or wolse (monthly rent); default sale"},"property":{"type":"string","enum":["house","officetel"],"description":"default house"},"price":{"type":"number","minimum":0,"description":"Sale price, or deposit for a lease (KRW)"},"monthlyRent":{"type":"number","minimum":0,"description":"Monthly rent, wolse only (KRW)"},"includeVat":{"type":"boolean","description":"Add 10% VAT to the fee; default true"}},"required":["price"],"additionalProperties":false},"example":{"transaction":"sale","price":500000000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"brokerage-fee","input":{"transaction":"sale","price":500000000},"result":{"maxFee":2200000,"transactionAmount":500000000,"ratePct":0.4,"feeCap":null,"feeExcludingVat":2000000,"vat":200000}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/jeonse-wolse-conversion":{"post":{"operationId":"jeonse_wolse_conversion","summary":"Convert between South Korean jeonse deposit and monthly rent (wolse) at a conversion rate, with the statutory 4","description":"Convert between South Korean jeonse deposit and monthly rent (wolse) at a conversion rate, with the statutory 4.5% cap check on a landlord's asked rent.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"direction":{"type":"string","enum":["jeonse_to_wolse","wolse_to_jeonse"],"description":"default jeonse_to_wolse"},"jeonseDeposit":{"type":"number","minimum":0,"description":"Current jeonse deposit (jeonse_to_wolse) (KRW)"},"newDeposit":{"type":"number","minimum":0,"description":"Deposit after conversion (jeonse_to_wolse) (KRW)"},"askedMonthlyRent":{"type":"number","minimum":0,"description":"Rent the landlord asks, to compare with the legal cap (KRW)"},"deposit":{"type":"number","minimum":0,"description":"Current deposit (wolse_to_jeonse) (KRW)"},"monthlyRent":{"type":"number","minimum":0,"description":"Current monthly rent (wolse_to_jeonse) (KRW)"},"ratePct":{"type":"number","minimum":0,"maximum":100,"description":"Annual conversion rate in percent; default 4.5 (statutory cap)"}},"additionalProperties":false},"example":{"jeonseDeposit":300000000,"newDeposit":100000000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"jeonse-wolse-conversion","input":{"jeonseDeposit":300000000,"newDeposit":100000000},"result":{"monthlyRent":750000,"convertedDeposit":200000000,"annualRent":9000000,"legalCapRatePct":4.5,"legalCapMonthlyRent":750000}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/child-benefits":{"post":{"operationId":"child_benefits","summary":"South Korea government cash support for a newborn","description":"South Korea government cash support for a newborn: first-meeting voucher, parent benefit for ages 0-1 and the monthly child allowance up to age 9, with a dated schedule.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"birthDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Birth or due date (YYYY-MM-DD)"},"firstChild":{"type":"boolean","description":"First child (voucher 2M) or later (3M); default true"},"area":{"type":"string","enum":["capital","non_capital","depopulation_preferred","depopulation_special"],"description":"Residence, sets the child allowance: capital area 100k, non-capital 105k, depopulation preferred 110k, special 120k per month; default capital"},"daycare":{"type":"boolean","description":"Child attends daycare at ages 0-1 (parent benefit offset by daycare fee); default false"}},"required":["birthDate"],"additionalProperties":false},"example":{"birthDate":"2026-11-10"}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"child-benefits","input":{"birthDate":"2026-11-10"},"result":{"total":30800000,"firstMeetingVoucher":2000000,"parentBenefitAge0":12000000,"parentBenefitAge1":6000000,"childAllowanceMonthly":100000,"childAllowanceTotal":10800000,"schedule":[{"stage":"age 0 (months 0-11)","from":"2026-11-10","to":"2027-11-09","monthly":1100000,"note":null},{"stage":"age 1 (months 12-23)","from":"2027-11-10","to":"2028-11-09","monthly":600000,"note":null},{"stage":"age 2 to under 9","from":"2028-11-10","to":"2035-11-09","monthly":100000,"note":"child allowance only"}]}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/business-days":{"post":{"operationId":"business_days","summary":"South Korea business days","description":"South Korea business days: count working days between two dates, or find the date N business days later, skipping weekends and Korean public holidays (2025-2027 table incl. substitute holidays).","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"mode":{"type":"string","enum":["count","add"],"description":"count days between startDate and endDate (default) or add N business days to startDate"},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Start date (YYYY-MM-DD)"},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"End date, count mode (YYYY-MM-DD)"},"days":{"type":"integer","minimum":1,"maximum":500,"description":"Business days to add, add mode; default 1"},"includeStart":{"type":"boolean","description":"Count the start date itself, count mode; default true"}},"required":["startDate"],"additionalProperties":false},"example":{"startDate":"2026-11-10","endDate":"2026-12-31"}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"business-days","input":{"startDate":"2026-11-10","endDate":"2026-12-31"},"result":{"businessDays":37,"totalDays":52,"weekendDays":14,"weekdayHolidays":1,"holidays":[{"date":"2026-12-25","name":"성탄절"}]}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/deposit-interest":{"post":{"operationId":"deposit_interest","summary":"South Korea bank deposit or installment-savings interest after tax","description":"South Korea bank deposit or installment-savings interest after tax: maturity amount with simple or monthly-compounded interest and the 15.4% interest withholding tax (or 9.5% preferential, or tax-free).","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kind":{"type":"string","enum":["deposit","savings"],"description":"deposit (lump sum) or savings (fixed monthly installment); default deposit"},"amount":{"type":"number","minimum":0,"description":"Principal, or monthly installment for savings (KRW)"},"months":{"type":"integer","minimum":1,"maximum":120,"description":"Term in months"},"annualRatePct":{"type":"number","minimum":0,"maximum":100,"description":"Annual interest rate in percent"},"compounding":{"type":"string","enum":["simple","monthly"],"description":"simple (default) or monthly compounding"},"taxRate":{"type":"number","enum":[0.154,0.095,0],"description":"Interest tax: 0.154 general (default), 0.095 preferential, 0 tax-free"}},"required":["amount","months","annualRatePct"],"additionalProperties":false},"example":{"kind":"savings","amount":500000,"months":12,"annualRatePct":4}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"deposit-interest","input":{"kind":"savings","amount":500000,"months":12,"annualRatePct":4},"result":{"maturityAmount":6109980,"principal":6000000,"interestBeforeTax":130000,"interestTax":20020,"interestAfterTax":109980,"equivalentDepositRatePct":2.17}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/korean-age":{"post":{"operationId":"korean_age","summary":"Korean age calculation","description":"Korean age calculation: international age (the legal standard in South Korea since June 2023), year age, traditional counting age, zodiac animal, and the next birthday.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"birthDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date of birth (YYYY-MM-DD)"},"referenceDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date to evaluate; default today (YYYY-MM-DD)"}},"required":["birthDate"],"additionalProperties":false},"example":{"birthDate":"1995-03-15","referenceDate":"2026-11-12"}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"korean-age","input":{"birthDate":"1995-03-15","referenceDate":"2026-11-12"},"result":{"internationalAge":31,"yearAge":31,"traditionalKoreanAge":32,"zodiac":"pig","isBirthday":false,"nextBirthday":"2027-03-15","daysUntilNextBirthday":123,"dayOfLife":11566}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/pyeong-conversion":{"post":{"operationId":"pyeong_conversion","summary":"Convert between square meters and pyeong, the Korean real-estate area unit (1 pyeong = 400/121 m2, about 3","description":"Convert between square meters and pyeong, the Korean real-estate area unit (1 pyeong = 400/121 m2, about 3.3058 m2).","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"value":{"type":"number","minimum":0,"description":"Area in the unit given by from"},"from":{"type":"string","enum":["sqm","pyeong"],"description":"Unit of value; default sqm"}},"required":["value"],"additionalProperties":false},"example":{"value":84}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"pyeong-conversion","input":{"value":84},"result":{"pyeong":25.41,"squareMeters":84,"squareSideMeters":9.2}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/pregnancy-due-date":{"post":{"operationId":"pregnancy_due_date","summary":"Pregnancy due date and gestational week from the last menstrual period, with the South Korean labor-law dates that follow","description":"Pregnancy due date and gestational week from the last menstrual period, with the South Korean labor-law dates that follow: reduced working hours in pregnancy, earliest maternity leave start, and the paternity leave deadline.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"lastPeriodDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"First day of the last menstrual period (YYYY-MM-DD)"},"cycleDays":{"type":"integer","minimum":20,"maximum":45,"description":"Cycle length in days; default 28"},"referenceDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date to evaluate; default today (YYYY-MM-DD)"}},"required":["lastPeriodDate"],"additionalProperties":false},"example":{"lastPeriodDate":"2026-07-01","referenceDate":"2026-11-12"}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"pregnancy-due-date","input":{"lastPeriodDate":"2026-07-01","referenceDate":"2026-11-12"},"result":{"dueDate":"2027-04-07","gestationalWeeks":19,"gestationalDays":1,"daysUntilDue":146,"trimester":2,"progressPct":48,"reducedHoursFirstPeriod":{"from":"2026-07-01","to":"2026-09-22"},"reducedHoursFromWeek32":"2027-02-10","earliestMaternityLeaveStart":"2027-02-22","maternityLeaveEndIfStartedEarliest":"2027-05-22","paternityLeaveDeadline":"2027-08-04"}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/service-period":{"post":{"operationId":"service_period","summary":"Length of service at a South Korean employer from the hire date","description":"Length of service at a South Korean employer from the hire date: years, months, days, next anniversary, annual leave entitlement for the current year of service, and severance pay eligibility.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Hire date (YYYY-MM-DD)"},"referenceDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date to evaluate; default today (YYYY-MM-DD)"}},"required":["startDate"],"additionalProperties":false},"example":{"startDate":"2022-03-02","referenceDate":"2026-11-12"}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"service-period","input":{"startDate":"2022-03-02","referenceDate":"2026-11-12"},"result":{"years":4,"months":8,"days":11,"totalDays":1717,"nextAnniversary":"2027-03-02","daysUntilNextAnniversary":110,"annualLeaveDaysPerYear":16,"monthlyLeaveDaysSoFar":null,"severanceEligible":true,"severanceEligibleFrom":null}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/gift-tax":{"post":{"operationId":"gift_tax","summary":"South Korea gift tax (jeungyeose) on a gift received","description":"South Korea gift tax (jeungyeose) on a gift received: relationship deduction (spouse 600M, parent to adult child 50M, to minor 20M, other relatives 10M), 10-year aggregation, marriage/childbirth deduction, 10-50% progressive rates, generation-skipping surcharge and the 3% on-time filing credit.","x-payment-info":{"protocol":"x402","price":"$0.10 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"amount":{"type":"number","minimum":0,"description":"Value of this gift (KRW)"},"donor":{"type":"string","enum":["spouse","lineal_ascendant","lineal_descendant","other_relative","unrelated"],"description":"Who gives: spouse, lineal_ascendant (parent or grandparent; default), lineal_descendant (child gives to parent), other_relative (within 6th degree by blood / 4th by marriage, incl. son- or daughter-in-law), unrelated"},"recipientMinor":{"type":"boolean","description":"Recipient is a minor (deduction 20M instead of 50M from a lineal ascendant); default false"},"priorGifts10y":{"type":"number","minimum":0,"description":"Gifts already received from the same donor in the previous 10 years (both parents count as one donor); assumed to have used the same relationship deduction (KRW)"},"marriageBirthDeduction":{"type":"number","minimum":0,"maximum":100000000,"description":"Marriage/childbirth deduction to claim, lifetime cap 100M combined, lineal_ascendant only (KRW)"},"generationSkipping":{"type":"boolean","description":"Gift from a grandparent to a grandchild while the parent is alive (30% surcharge, 40% for a minor receiving over 2 billion); default false"},"filedOnTime":{"type":"boolean","description":"Filed within 3 months after the end of the gift month (3% credit); default true"}},"required":["amount"],"additionalProperties":false},"example":{"amount":150000000,"donor":"lineal_ascendant"}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"gift-tax","input":{"amount":150000000,"donor":"lineal_ascendant"},"result":{"tax":9700000,"aggregatedGifts":150000000,"deduction":50000000,"relationshipDeductionLimit":50000000,"taxBase":100000000,"computedTax":10000000,"generationSkippingSurcharge":0,"priorGiftTaxCredit":0,"filingCredit":300000,"netReceived":140300000}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/housing-acquisition-tax":{"post":{"operationId":"housing_acquisition_tax","summary":"South Korea acquisition tax when buying a home","description":"South Korea acquisition tax when buying a home: 1-3% by price (sliding rate between 600M and 900M), 8%/12% heavy rates for multiple homes and corporations, plus local education tax and rural special tax, and the first-home relief of up to 2M.","x-payment-info":{"protocol":"x402","price":"$0.05 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"price":{"type":"number","minimum":0,"description":"Purchase price (KRW)"},"homesAfterPurchase":{"type":"integer","minimum":1,"maximum":20,"description":"Homes the household owns including this one; default 1"},"regulatedArea":{"type":"boolean","description":"Home is in an adjustment-target area (jojeong daesang jiyeok), where heavy rates start from the 2nd home; default false"},"corporation":{"type":"boolean","description":"Buyer is a corporation (12%); default false"},"areaOver85sqm":{"type":"boolean","description":"Exclusive area over 85 m2 (rural special tax applies); default false"},"firstHome":{"type":"boolean","description":"First home ever for the household, price up to 1.2B (relief up to 2M of acquisition tax; surtax adjustments not modeled); default false"}},"required":["price"],"additionalProperties":false},"example":{"price":750000000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"housing-acquisition-tax","input":{"price":750000000},"result":{"total":16500000,"acquisitionTax":15000000,"localEducationTax":1500000,"ruralSpecialTax":0,"acquisitionTaxRatePct":2,"heavyRateApplied":false,"effectiveRatePct":2.2,"firstHomeRelief":0,"totalAfterFirstHomeRelief":16500000}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/vehicle-tax":{"post":{"operationId":"vehicle_tax","summary":"South Korea annual vehicle tax (jadongchase) for a private passenger car","description":"South Korea annual vehicle tax (jadongchase) for a private passenger car: per-cc rate by engine displacement, 30% local education tax, age reduction from the 3rd year (5% a year, up to 50%), flat amount for electric cars, and the 2026 annual-prepayment discount.","x-payment-info":{"protocol":"x402","price":"$0.05 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"displacementCc":{"type":"number","minimum":0,"maximum":10000,"description":"Engine displacement in cc; not needed for electric"},"vehicleAgeYears":{"type":"integer","minimum":1,"maximum":50,"description":"Vehicle age counted from first registration, 1 = first year; default 1"},"electric":{"type":"boolean","description":"Battery electric car (flat 100,000 plus education tax); default false"},"prepayMonth":{"type":"number","enum":[0,1,3,6,9],"description":"Month of annual prepayment (1, 3, 6 or 9) for the 5% discount on the remaining period; 0 = no prepayment (default)"}},"additionalProperties":false},"example":{"displacementCc":1998,"vehicleAgeYears":5,"prepayMonth":1}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"vehicle-tax","input":{"displacementCc":1998,"vehicleAgeYears":5,"prepayMonth":1},"result":{"annualTotal":441550,"vehicleTax":339660,"localEducationTax":101890,"perCcRate":200,"ageReductionPct":15,"perHalfYear":220770,"prepayDiscount":20200,"annualTotalAfterPrepay":421350}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/income-tax-from-tax-base":{"post":{"operationId":"income_tax_from_tax_base","summary":"South Korea comprehensive income tax from a tax base (gwase pyojun)","description":"South Korea comprehensive income tax from a tax base (gwase pyojun): the 8-bracket 6-45% progressive table with deduction amounts, plus 10% local income tax, marginal and effective rates.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"taxBase":{"type":"number","minimum":0,"description":"Tax base: income after all deductions (KRW)"}},"required":["taxBase"],"additionalProperties":false},"example":{"taxBase":50000000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"income-tax-from-tax-base","input":{"taxBase":50000000},"result":{"incomeTax":6240000,"localIncomeTax":624000,"total":6864000,"marginalRatePct":15,"effectiveRatePct":13.7}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/loan-repayment":{"post":{"operationId":"loan_repayment","summary":"Loan repayment schedule summary as used by South Korean banks","description":"Loan repayment schedule summary as used by South Korean banks: equal monthly payment (wolligeum gyundeung), equal principal (wongeum gyundeung) or interest-only with bullet repayment; monthly payment, first and last installments, total interest.","x-payment-info":{"protocol":"x402","price":"$0.05 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"principal":{"type":"number","minimum":0,"description":"Loan principal (KRW)"},"annualRatePct":{"type":"number","minimum":0,"maximum":100,"description":"Annual interest rate in percent"},"months":{"type":"integer","minimum":1,"maximum":600,"description":"Loan term in months"},"method":{"type":"string","enum":["equal_payment","equal_principal","bullet"],"description":"equal_payment (default), equal_principal, or bullet (interest monthly, principal at maturity)"}},"required":["principal","annualRatePct","months"],"additionalProperties":false},"example":{"principal":300000000,"annualRatePct":4.2,"months":360}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"loan-repayment","input":{"principal":300000000,"annualRatePct":4.2,"months":360},"result":{"monthlyPayment":1467052,"firstPayment":{"principal":417052,"interest":1050000,"payment":1467052},"lastPayment":{"principal":1461588,"interest":5116,"payment":1466704},"totalInterest":228138372,"totalPayment":528138372}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/early-repayment-fee":{"post":{"operationId":"early_repayment_fee","summary":"South Korea early loan repayment fee (jungdo sanghwan susuryo)","description":"South Korea early loan repayment fee (jungdo sanghwan susuryo): repaid amount x fee rate x remaining days / fee period (usually 3 years, after which the fee is waived).","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"repayAmount":{"type":"number","minimum":0,"description":"Amount repaid early (KRW)"},"feeRatePct":{"type":"number","minimum":0,"maximum":10,"description":"Fee rate in percent from the loan contract, e.g. 1.2"},"elapsedDays":{"type":"number","minimum":0,"maximum":20000,"description":"Days since the loan was taken out"},"feePeriodDays":{"type":"integer","minimum":1,"maximum":20000,"description":"Period during which the fee applies, in days; default 1095 (3 years)"}},"required":["repayAmount","feeRatePct","elapsedDays"],"additionalProperties":false},"example":{"repayAmount":100000000,"feeRatePct":1.2,"elapsedDays":365}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"early-repayment-fee","input":{"repayAmount":100000000,"feeRatePct":1.2,"elapsedDays":365},"result":{"fee":800000,"remainingDays":730,"waived":false}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/inheritance-shares":{"post":{"operationId":"inheritance_shares","summary":"South Korea statutory inheritance shares and forced-heirship reserve (yuryubun) under the Civil Code","description":"South Korea statutory inheritance shares and forced-heirship reserve (yuryubun) under the Civil Code: heirs by rank (children, then parents, then siblings), the spouse 50% add-on, and reserved portions (1/2 of the share for children and spouse, 1/3 for parents, none for siblings). Representation (daeseup) and heirs beyond siblings are not modeled.","x-payment-info":{"protocol":"x402","price":"$0.10 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"spouse":{"type":"boolean","description":"Surviving legally married spouse; default false"},"children":{"type":"integer","minimum":0,"maximum":30,"description":"Number of children (lineal descendants of the nearest degree)"},"parents":{"type":"integer","minimum":0,"maximum":4,"description":"Number of surviving parents (lineal ascendants of the nearest degree); inherit only if there are no children"},"siblings":{"type":"integer","minimum":0,"maximum":30,"description":"Number of siblings; inherit only if there is no spouse, child or parent"},"estate":{"type":"number","minimum":0,"description":"Estate value, to get amounts (KRW)"}},"additionalProperties":false},"example":{"spouse":true,"children":2,"estate":700000000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"inheritance-shares","input":{"spouse":true,"children":2,"estate":700000000},"result":{"rank":1,"heirs":[{"heir":"spouse","share":"3/7","sharePct":42.86,"amount":300000000,"reservedShare":"3/14","reservedAmount":150000000},{"heir":"child","share":"2/7","sharePct":28.57,"amount":200000000,"reservedShare":"1/7","reservedAmount":100000000,"count":2}]}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/housing-subscription-score":{"post":{"operationId":"housing_subscription_score","summary":"South Korea housing subscription points (cheongyak gajeom, max 84) for private apartment sales","description":"South Korea housing subscription points (cheongyak gajeom, max 84) for private apartment sales: homeless period (max 32), dependents (max 35) and subscription account period (max 17). The spouse-account bonus is not included.","x-payment-info":{"protocol":"x402","price":"$0.05 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ownsHome":{"type":"boolean","description":"Applicant or spouse owns a home (homeless-period points become 0); default false"},"homelessYears":{"type":"number","minimum":0,"maximum":80,"description":"Years without a home, counted from age 30 or from marriage registration if earlier"},"dependents":{"type":"integer","minimum":0,"maximum":20,"description":"Dependents in the household, excluding the applicant"},"accountYears":{"type":"number","minimum":0,"maximum":80,"description":"Years since the subscription savings account was opened"}},"additionalProperties":false},"example":{"homelessYears":10.5,"dependents":3,"accountYears":7.2}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"housing-subscription-score","input":{"homelessYears":10.5,"dependents":3,"accountYears":7.2},"result":{"total":51,"homelessPeriodPoints":22,"dependentsPoints":20,"accountPeriodPoints":9,"maximum":84}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/litigation-stamp-fee":{"post":{"operationId":"litigation_stamp_fee","summary":"South Korea civil lawsuit filing costs","description":"South Korea civil lawsuit filing costs: court stamp fee (injidae) from the claim amount by bracket, 1.5x on appeal and 2x at the Supreme Court, 10% off for electronic filing, plus the prepaid service-of-process fee (songdallyo).","x-payment-info":{"protocol":"x402","price":"$0.05 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"claimAmount":{"type":"number","minimum":0,"description":"Amount in dispute (soga) (KRW)"},"instance":{"type":"string","enum":["first","appeal","supreme"],"description":"Court level; default first"},"electronic":{"type":"boolean","description":"Filed through the electronic litigation system (10% off the stamp fee); default true"},"parties":{"type":"integer","minimum":2,"maximum":100,"description":"Number of parties, for the service fee; default 2"}},"required":["claimAmount"],"additionalProperties":false},"example":{"claimAmount":50000000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"litigation-stamp-fee","input":{"claimAmount":50000000},"result":{"stampFee":207000,"stampFeePaperFiling":230000,"serviceFee":169200,"serviceRoundsPerParty":15,"total":376200,"smallClaim":false}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/late-payment-interest":{"post":{"operationId":"late_payment_interest","summary":"South Korea statutory late-payment interest (jiyeon sonhaegeum) on a money debt","description":"South Korea statutory late-payment interest (jiyeon sonhaegeum) on a money debt: 5% civil, 6% commercial, 12% under the litigation-promotion act after a complaint is served, or a contract rate, prorated by day.","x-payment-info":{"protocol":"x402","price":"$0.05 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"principal":{"type":"number","minimum":0,"description":"Unpaid principal (KRW)"},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"First day interest accrues (YYYY-MM-DD)"},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Last day counted; default today (YYYY-MM-DD)"},"rate":{"type":"string","enum":["civil","commercial","litigation","custom"],"description":"civil 5% (default), commercial 6%, litigation 12%, or custom"},"customRatePct":{"type":"number","minimum":0,"maximum":100,"description":"Annual rate in percent when rate is custom"}},"required":["principal","startDate"],"additionalProperties":false},"example":{"principal":10000000,"startDate":"2026-01-01","endDate":"2026-10-31","rate":"litigation"}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"late-payment-interest","input":{"principal":10000000,"startDate":"2026-01-01","endDate":"2026-10-31","rate":"litigation"},"result":{"interest":999452,"days":304,"annualRatePct":12,"totalDue":10999452,"perDay":3288}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/resignation-settlement":{"post":{"operationId":"resignation_settlement","summary":"South Korea resignation settlement in one call","description":"South Korea resignation settlement in one call: statutory severance pay, retirement income tax and local tax, net severance, unused annual-leave pay, and how much more you get by moving the last working day (one more day, week, month, or until the next annual-leave grant). Uses the ordinary wage when it is higher than the average wage. Optionally adds the unemployment benefit estimate for an involuntary separation.","x-payment-info":{"protocol":"x402","price":"$0.10 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Hire date (YYYY-MM-DD)"},"lastWorkDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Last working day; default today (YYYY-MM-DD)"},"monthlyPay":{"type":"number","minimum":0,"description":"Average gross monthly pay for the last 3 months (KRW)"},"annualBonus":{"type":"number","minimum":0,"description":"Bonuses paid in the last 12 months (KRW)"},"monthlyOrdinaryWage":{"type":"number","minimum":0,"description":"Monthly ordinary wage; defaults to monthlyPay (KRW)"},"unusedLeaveDays":{"type":"number","minimum":0,"maximum":200,"description":"Accrued annual-leave days not yet used; default 0"},"fiveOrMoreEmployees":{"type":"boolean","description":"Workplace has 5+ employees (annual leave rules apply); default true"},"age":{"type":"integer","minimum":15,"maximum":100,"description":"Age at separation; with insuredYears, adds the unemployment benefit estimate"},"insuredYears":{"type":"number","minimum":0,"maximum":60,"description":"Years insured under employment insurance"}},"required":["startDate","monthlyPay"],"additionalProperties":false},"example":{"startDate":"2023-03-02","lastWorkDate":"2026-03-01","monthlyPay":3500000,"unusedLeaveDays":5}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"resignation-settlement","input":{"startDate":"2023-03-02","lastWorkDate":"2026-03-01","monthlyPay":3500000,"unusedLeaveDays":5},"result":{"totalPayout":12551684,"severanceEligible":true,"severancePayGross":12068428,"retirementIncomeTax":169640,"localIncomeTax":16960,"severancePayNet":11881828,"unusedLeavePay":669856,"daysEmployed":1096,"taxableServiceYears":3,"averageDailyWage":133971,"dailyOrdinaryWage":133971,"severanceEligibleFrom":null,"nextLeaveGrant":{"date":"2026-03-02","days":16,"extraLeavePay":2143541},"ifLastWorkDateWere":[{"lastWorkDate":"2026-03-02","label":"one more day","extraDays":1,"severancePayNet":11936549,"unusedLeavePay":2813397,"gain":2198262},{"lastWorkDate":"2026-03-08","label":"one more week","extraDays":7,"severancePayNet":12000877,"unusedLeavePay":2813397,"gain":2262590},{"lastWorkDate":"2026-04-01","label":"one more month","extraDays":31,"severancePayNet":12258169,"unusedLeavePay":2813397,"gain":2519882}]}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/job-offer-comparison":{"post":{"operationId":"job_offer_comparison","summary":"Compare a South Korean job offer with the current job on what actually matters","description":"Compare a South Korean job offer with the current job on what actually matters: annual take-home pay including bonus (after 2026 social insurance and withholding tax), monthly take-home, and real hourly net pay once commuting time is counted. Assumes KRW 200,000 monthly non-taxable pay and 1 dependent.","x-payment-info":{"protocol":"x402","price":"$0.05 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"current":{"type":"object","properties":{"annualSalary":{"type":"number","minimum":0,"description":"Gross annual salary (KRW)"},"annualBonus":{"type":"number","minimum":0,"description":"Annual bonus; default 0 (KRW)"},"commuteMinutesPerDay":{"type":"number","minimum":0,"maximum":600,"description":"Round-trip commute per working day in minutes; default 0"},"weeklyHours":{"type":"number","minimum":1,"maximum":100,"description":"Weekly working hours; default 40"}},"required":["annualSalary"],"additionalProperties":false,"description":"Current job"},"offer":{"type":"object","properties":{"annualSalary":{"type":"number","minimum":0,"description":"Gross annual salary (KRW)"},"annualBonus":{"type":"number","minimum":0,"description":"Annual bonus; default 0 (KRW)"},"commuteMinutesPerDay":{"type":"number","minimum":0,"maximum":600,"description":"Round-trip commute per working day in minutes; default 0"},"weeklyHours":{"type":"number","minimum":1,"maximum":100,"description":"Weekly working hours; default 40"}},"required":["annualSalary"],"additionalProperties":false,"description":"Job offer"}},"required":["current","offer"],"additionalProperties":false},"example":{"current":{"annualSalary":42000000,"annualBonus":2000000,"commuteMinutesPerDay":60},"offer":{"annualSalary":46000000,"commuteMinutesPerDay":100}}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"job-offer-comparison","input":{"current":{"annualSalary":42000000,"annualBonus":2000000,"commuteMinutesPerDay":60},"offer":{"annualSalary":46000000,"commuteMinutesPerDay":100}},"result":{"annualNetDifference":1547360,"salaryIncreasePct":9.5,"realHourlyNetDifference":-513,"current":{"monthlyNetExcludingBonus":3066300,"annualNetIncludingBonus":38343440,"workAndCommuteHoursPerYear":2346,"realHourlyNet":16341},"offer":{"monthlyNetExcludingBonus":3324243,"annualNetIncludingBonus":39890800,"workAndCommuteHoursPerYear":2520,"realHourlyNet":15828}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/stock-transaction-tax":{"post":{"operationId":"stock_transaction_tax","summary":"South Korea securities transaction tax on selling listed shares (2026 rates)","description":"South Korea securities transaction tax on selling listed shares (2026 rates): KOSPI 0.05% plus 0.15% rural special tax, KOSDAQ 0.20%, charged on the sale amount whether or not there is a gain.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sellAmount":{"type":"number","minimum":0,"description":"Sale amount (price x quantity) (KRW)"},"market":{"type":"string","enum":["kospi","kosdaq"],"description":"Market; default kospi"}},"required":["sellAmount"],"additionalProperties":false},"example":{"sellAmount":10000000,"market":"kospi"}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"stock-transaction-tax","input":{"sellAmount":10000000,"market":"kospi"},"result":{"total":20000,"securitiesTransactionTax":5000,"ruralSpecialTax":15000,"totalRatePct":0.2,"netProceeds":9980000}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/rental-income-separate-tax":{"post":{"operationId":"rental_income_separate_tax","summary":"South Korea housing rental income tax under separate taxation (annual rent up to 20 million KRW)","description":"South Korea housing rental income tax under separate taxation (annual rent up to 20 million KRW): 14% on rent minus deemed expenses (50%, or 60% for registered rental housing) and the basic deduction (2M, or 4M registered, only if other income is 20M or less), plus local income tax. Deemed rent on deposits and registered-housing tax reductions are not modeled.","x-payment-info":{"protocol":"x402","price":"$0.05 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"annualRent":{"type":"number","minimum":0,"maximum":20000000,"description":"Annual housing rental income (KRW)"},"registered":{"type":"boolean","description":"Registered rental housing (60% expenses, 4M deduction); default false"},"otherIncomeOver20M":{"type":"boolean","description":"Other comprehensive income amount exceeds 20M (no basic deduction); default false"}},"required":["annualRent"],"additionalProperties":false},"example":{"annualRent":9600000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"rental-income-separate-tax","input":{"annualRent":9600000},"result":{"total":431200,"incomeTax":392000,"localIncomeTax":39200,"deemedExpenses":4800000,"basicDeduction":2000000,"taxBase":2800000,"effectiveRatePct":4.5}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/financial-income-tax":{"post":{"operationId":"financial_income_tax","summary":"South Korea comprehensive taxation of financial income (interest and dividends over 20 million KRW a year)","description":"South Korea comprehensive taxation of financial income (interest and dividends over 20 million KRW a year): compares the comprehensive method (first 20M at 14%, the excess added to other income at 6-45%) with the 14% separate method and takes the larger, then shows tax due beyond what was withheld. Dividend gross-up and the 2026 high-dividend separate-taxation option are not modeled.","x-payment-info":{"protocol":"x402","price":"$0.05 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"financialIncome":{"type":"number","minimum":0,"description":"Total interest and dividend income for the year, before tax (KRW)"},"otherTaxBase":{"type":"number","minimum":0,"description":"Tax base of other comprehensive income (after deductions), e.g. wage or business income; default 0 (KRW)"}},"required":["financialIncome"],"additionalProperties":false},"example":{"financialIncome":50000000,"otherTaxBase":50000000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"financial-income-tax","input":{"financialIncome":50000000,"otherTaxBase":50000000},"result":{"comprehensiveTaxation":true,"totalIncomeTax":16240000,"method":"comprehensive","comprehensiveMethodTax":16240000,"separateMethodTax":13240000,"taxOnOtherIncomeAlone":6240000,"withheldOnFinancialIncome":7000000,"additionalIncomeTaxDue":3000000,"additionalLocalIncomeTax":300000}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/unemployment-eligibility":{"post":{"operationId":"unemployment_eligibility","summary":"South Korea unemployment benefit eligibility check","description":"South Korea unemployment benefit eligibility check: at least 180 insured days in the 18 months before leaving, an involuntary (or justified) reason for leaving, and being able and actively seeking work. Use unemployment-benefit for the amount.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"insuredDaysLast18Months":{"type":"number","minimum":0,"maximum":600,"description":"Paid days under employment insurance in the 18 months before separation (includes paid weekly holidays)"},"reason":{"type":"string","enum":["dismissal","recommended_resignation","contract_expiry","business_closure","retirement_age","voluntary_justified","voluntary","serious_misconduct"],"description":"Reason for leaving. voluntary_justified covers quitting for a legally recognized reason such as unpaid wages, workplace harassment or a commute over 3 hours"},"ableAndSeeking":{"type":"boolean","description":"Able to work and actively looking for a job; default true"}},"required":["insuredDaysLast18Months","reason"],"additionalProperties":false},"example":{"insuredDaysLast18Months":240,"reason":"contract_expiry"}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"unemployment-eligibility","input":{"insuredDaysLast18Months":240,"reason":"contract_expiry"},"result":{"eligible":true,"failedConditions":[],"insuredDaysShort":0,"needsProof":false,"applyWithinMonthsOfSeparation":12}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/weekly-hours-check":{"post":{"operationId":"weekly_hours_check","summary":"South Korea 52-hour workweek check under the Labor Standards Act","description":"South Korea 52-hour workweek check under the Labor Standards Act: 40 standard hours plus at most 12 overtime hours a week (35 plus 5 for workers under 18); workplaces with fewer than 5 employees are exempt for adults.","x-payment-info":{"protocol":"x402","price":"$0.01 USDC","network":"eip155:8453","freeOnMcp":true},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"weeklyHours":{"type":"number","minimum":0,"maximum":168,"description":"Hours actually worked in the week"},"fiveOrMoreEmployees":{"type":"boolean","description":"Workplace has 5 or more employees; default true"},"minor":{"type":"boolean","description":"Worker is under 18; default false"}},"required":["weeklyHours"],"additionalProperties":false},"example":{"weeklyHours":55}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"basisYear":2026,"currency":"KRW","disclaimer":"For reference only, not legal, tax or financial advice. Computed from South Korean statutes and standard formulas as of 2026; reliefs, exemptions and special cases not shown in the result are not modeled, and rules may have changed. Confirm with the relevant office, court, lender or a professional before acting.","source":"https://kkuldogu.com","tool":"weekly-hours-check","input":{"weeklyHours":55},"result":{"applicable":true,"standardHours":40,"maxOvertimeHours":12,"legalMaxHours":52,"overtimeHours":15,"exceedsLegalLimit":true,"excessHours":3}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/severance-batch":{"post":{"operationId":"severance_batch","summary":"South Korea statutory severance pay for up to 100 employees in one call","description":"South Korea statutory severance pay for up to 100 employees in one call: per-employee gross severance, retirement income tax and net amount using the same calculation as severance-pay (Ministry of Employment and Labor rounding, optional ordinary-wage comparison), with company-wide totals.","x-payment-info":{"protocol":"x402","price":"$0.10 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"employees":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":64,"description":"Your identifier, echoed back"},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Hire date (YYYY-MM-DD)"},"lastWorkDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Last working day; default today (YYYY-MM-DD)"},"monthlyPay":{"type":"number","minimum":0,"description":"Average monthly pay for the last 3 months (KRW)"},"annualBonus":{"type":"number","minimum":0,"description":"Bonuses paid in the last 12 months (KRW)"},"annualLeavePay":{"type":"number","minimum":0,"description":"Annual-leave allowance paid in the last 12 months (KRW)"},"monthlyOrdinaryWage":{"type":"number","minimum":0,"description":"Monthly ordinary wage, to apply the ordinary-wage comparison (KRW)"}},"required":["startDate","monthlyPay"],"additionalProperties":false},"description":"Employees, 1-100"}},"required":["employees"],"additionalProperties":false},"example":{"employees":[{"id":"kim","startDate":"2021-03-02","lastWorkDate":"2026-03-01","monthlyPay":3500000},{"id":"lee","startDate":"2019-07-01","lastWorkDate":"2026-10-31","monthlyPay":4200000,"annualBonus":6000000}]}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"severance-batch","input":{"employees":[{"id":"kim","startDate":"2021-03-02","lastWorkDate":"2026-03-01","monthlyPay":3500000},{"id":"lee","startDate":"2019-07-01","lastWorkDate":"2026-10-31","monthlyPay":4200000,"annualBonus":6000000}]},"result":{"headcount":2,"eligibleCount":2,"totals":{"severancePayGross":51268971,"tax":702290,"severancePayNet":50566681},"employees":[{"id":"kim","eligible":true,"daysEmployed":1826,"averageDailyWage":116667,"averageDailyWageExact":116666.67,"severancePayGross":17509590,"tax":242250,"severancePayNet":17267340,"taxableServiceYears":5,"ordinaryWageCompared":false,"ordinaryWageApplied":false,"dailyOrdinaryWage":null,"eligibleFrom":null},{"id":"lee","eligible":true,"daysEmployed":2680,"averageDailyWage":153261,"averageDailyWageExact":153260.87,"severancePayGross":33759381,"tax":460040,"severancePayNet":33299341,"taxableServiceYears":8,"ordinaryWageCompared":false,"ordinaryWageApplied":false,"dailyOrdinaryWage":null,"eligibleFrom":null}]}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/payroll-batch":{"post":{"operationId":"payroll_batch","summary":"South Korea monthly payroll run for up to 100 employees in one call","description":"South Korea monthly payroll run for up to 100 employees in one call: per-employee take-home pay with each deduction (national pension, health, long-term care, employment insurance, income tax from the 2026 NTS withholding table, local income tax), employer social-insurance contributions, and company-wide totals including total employer cost. Industrial accident insurance (industry-specific rate) is not included.","x-payment-info":{"protocol":"x402","price":"$0.10 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"employees":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":64,"description":"Your identifier, echoed back"},"annualSalary":{"type":"number","minimum":0,"description":"Gross annual salary (KRW)"},"monthlySalary":{"type":"number","minimum":0,"description":"Gross monthly salary; overrides annualSalary (KRW)"},"nonTaxable":{"type":"number","minimum":0,"description":"Monthly non-taxable allowances; default 200000 (KRW)"},"dependents":{"type":"integer","minimum":1,"maximum":20,"description":"Dependents including self; default 1"},"children8to20":{"type":"integer","minimum":0,"maximum":10,"description":"Children aged 8-20; default 0"},"severanceIncluded":{"type":"boolean","description":"Annual salary includes severance (divided by 13)"}},"additionalProperties":false},"description":"Employees, 1-100"},"employerSize":{"type":"string","enum":["under150","150plus_priority","150to999","1000plus"],"description":"Employer headcount bracket for the employer employment-insurance rate; default under150"}},"required":["employees"],"additionalProperties":false},"example":{"employees":[{"id":"kim","annualSalary":40000000},{"id":"lee","monthlySalary":5000000,"dependents":3,"children8to20":1}]}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"payroll-batch","input":{"employees":[{"id":"kim","annualSalary":40000000},{"id":"lee","monthlySalary":5000000,"dependents":3,"children8to20":1}]},"result":{"headcount":2,"totals":{"grossMonthly":8333333,"netMonthly":7259043,"employeeDeductions":1074290,"incomeTaxWithheld":275840,"localIncomeTaxWithheld":27580,"employeeInsurance":770870,"employerInsurance":790710,"employerCost":9124043},"employees":[{"id":"kim","grossMonthly":3333333,"netMonthly":2935813,"employeeDeductions":397520,"deductions":{"nationalPension":148810,"healthInsurance":112640,"longTermCare":14800,"employmentInsurance":28190,"incomeTax":84620,"localIncomeTax":8460},"employerInsurance":312280,"employerCost":3645613},{"id":"lee","grossMonthly":5000000,"netMonthly":4323230,"employeeDeductions":676770,"deductions":{"nationalPension":228000,"healthInsurance":172560,"longTermCare":22670,"employmentInsurance":43200,"incomeTax":191220,"localIncomeTax":19120},"employerInsurance":478430,"employerCost":5478430}]}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}},"/v1/new-parent-benefits":{"post":{"operationId":"new_parent_benefits","summary":"Everything a South Korean household receives around a birth, in one call","description":"Everything a South Korean household receives around a birth, in one call: maternity leave pay (90/120 days, who pays what), parental leave benefit month by month (normal, 6+6 both-parents, or single-parent scheme), the spouse's 20-day childbirth leave pay, and government cash support for the child (first-meeting voucher, parent benefit, child allowance to age 9).","x-payment-info":{"protocol":"x402","price":"$0.10 USDC","network":"eip155:8453","freeOnMcp":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"birthDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Birth or due date (YYYY-MM-DD)"},"monthlyOrdinaryWage":{"type":"number","minimum":0,"description":"Monthly ordinary wage of the parent taking maternity leave (KRW)"},"multipleBirth":{"type":"boolean","description":"Twins or more (120 days); default false"},"priorityCompany":{"type":"boolean","description":"Employer is a priority-support (SME) company; default true"},"parentalLeaveMonths":{"type":"integer","minimum":0,"maximum":18,"description":"Months of parental leave after maternity leave; default 12, 0 for none"},"parentalLeaveMode":{"type":"string","enum":["normal","both_parents","single_parent"],"description":"normal (default), both_parents (6+6 scheme; needs the spouse fields) or single_parent"},"spouseMonthlyOrdinaryWage":{"type":"number","minimum":0,"description":"Spouse's monthly ordinary wage; adds the spouse's childbirth leave pay (KRW)"},"spousePriorityCompany":{"type":"boolean","description":"Spouse's employer is a priority-support company; default true"},"spouseParentalLeaveMonths":{"type":"integer","minimum":0,"maximum":18,"description":"Months of parental leave the spouse takes; default 0"},"firstChild":{"type":"boolean","description":"First child (voucher KRW 2,000,000; later children 3,000,000); default true"},"area":{"type":"string","enum":["capital","non_capital","depopulation_preferred","depopulation_special"],"description":"Residence area for the child allowance amount; default capital"},"daycare":{"type":"boolean","description":"Child attends daycare (parent benefit replaced by the daycare subsidy); default false"}},"required":["birthDate","monthlyOrdinaryWage"],"additionalProperties":false},"example":{"birthDate":"2026-11-13","monthlyOrdinaryWage":3500000,"spouseMonthlyOrdinaryWage":4000000}}}},"responses":{"200":{"description":"Calculation result","content":{"application/json":{"schema":{"type":"object","required":["basisYear","currency","disclaimer","tool","input","result"],"properties":{"basisYear":{"type":"integer"},"currency":{"type":"string"},"disclaimer":{"type":"string"},"source":{"type":"string"},"tool":{"type":"string"},"input":{"type":"object","description":"Validated input as received"},"result":{"type":"object","description":"Calculation result; amounts in KRW"}}},"example":{"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":"new-parent-benefits","input":{"birthDate":"2026-11-13","monthlyOrdinaryWage":3500000,"spouseMonthlyOrdinaryWage":4000000},"result":{"totals":{"leavePayAndBenefits":35362201,"childBenefitsUntilAge9":30800000,"all":66162201},"maternityLeave":{"leaveDays":90,"employerPaidDays":60,"total":9200000,"employerPaidPeriod":7000000,"remainingPeriod":2200000,"fromEmploymentInsurance":6600000,"fromEmployer":2600000},"parentalLeave":{"total":23100000,"self":{"monthly":[{"month":1,"amount":2500000,"cap":2500000},{"month":2,"amount":2500000,"cap":2500000},{"month":3,"amount":2500000,"cap":2500000},{"month":4,"amount":2000000,"cap":2000000},{"month":5,"amount":2000000,"cap":2000000},{"month":6,"amount":2000000,"cap":2000000},{"month":7,"amount":1600000,"cap":1600000},{"month":8,"amount":1600000,"cap":1600000},{"month":9,"amount":1600000,"cap":1600000},{"month":10,"amount":1600000,"cap":1600000},{"month":11,"amount":1600000,"cap":1600000},{"month":12,"amount":1600000,"cap":1600000}],"total":23100000}},"spouseParentalLeave":null,"spousePaternityLeave":{"leaveDays":20,"total":3062201,"dailyOrdinaryWage":153110,"fromEmploymentInsurance":1684210,"fromEmployer":1377991},"childBenefits":{"total":30800000,"firstMeetingVoucher":2000000,"parentBenefitAge0":12000000,"parentBenefitAge1":6000000,"childAllowanceMonthly":100000,"childAllowanceTotal":10800000,"schedule":[{"stage":"age 0 (months 0-11)","from":"2026-11-13","to":"2027-11-12","monthly":1100000,"note":null},{"stage":"age 1 (months 12-23)","from":"2027-11-13","to":"2028-11-12","monthly":600000,"note":null},{"stage":"age 2 to under 9","from":"2028-11-13","to":"2035-11-12","monthly":100000,"note":"child allowance only"}]}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}},"message":{"type":"string"}}}}}},"402":{"description":"Payment required (x402). Payment requirements are in the PAYMENT-REQUIRED response header."}}}}}}