Korea Payroll & Tax API › year-end-tax-settlement
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.
Price: $0.10 USDC per call over REST (x402 on Base, no API key). MCP: paid-only — the MCP tool returns payment instructions. Basis year: 2026.
| Field | Type | Required | Description |
|---|---|---|---|
grossSalary | number | yes | Annual gross salary excluding non-taxable pay (KRW) |
taxWithheld | number | Income tax already withheld this year; estimated from the withholding table if omitted (KRW) | |
dependents | integer | Persons for the basic deduction, including self; default 1 | |
children | integer | Children among dependents | |
children8to20 | integer | Children aged 8 or older (child tax credit) | |
birthOrder | 0 | 1 | 2 | 3 | Birth/adoption this year: 0 none, 1 first, 2 second, 3 third or later | |
seniors70 | integer | Dependents aged 70+ | |
disabled | integer | Disabled dependents including self | |
marriedThisYear | boolean | Marriage registered this year (KRW 500,000 credit) | |
creditCard | number | Credit card spending (KRW) | |
debitCash | number | Debit card and cash-receipt spending (KRW) | |
traditionalMarketTransit | number | Traditional market and public transport spending (KRW) | |
cultureSports | number | Books, performances, cinema, gym spending (salary up to 70M) (KRW) | |
insurancePremiums | number | Protection-type insurance premiums (KRW) | |
medical | number | Medical expenses (KRW) | |
education | number | Education expenses (KRW) | |
donations | number | Donations (KRW) | |
pensionSavings | number | Pension savings contributions (KRW) | |
irp | number | IRP contributions (KRW) | |
annualRent | number | Monthly rent paid over the year (homeless householder) (KRW) | |
housingSubscription | number | Housing subscription savings contributions (KRW) |
curl -X POST https://api.kkuldogu.com/v1/year-end-tax-settlement -H "content-type: application/json" \
-d '{"grossSalary":50000000,"creditCard":15000000,"debitCash":5000000,"insurancePremiums":1000000,"medical":500000}'Without payment this returns 402 with x402 payment requirements; an x402 client pays $0.10 USDC and retries.
{
"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
}
}
}For reference only, not legal or tax advice. Uses official 2026 Korean rates and the same formulas as the kkuldogu.com calculators; actual payroll, NHIS/NPS notices and tax settlement can differ. · Calculators for people (Korean): kkuldogu.com · API home · llms.txt · OpenAPI