Korea Payroll & Tax API › housing-subscription-score

South Korea housing subscription points (cheongyak gajeom, max 84) for private apartment sales

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.

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

Input

Field	Type	Description
`ownsHome`	boolean	Applicant or spouse owns a home (homeless-period points become 0); default false
`homelessYears`	number	Years without a home, counted from age 30 or from marriage registration if earlier
`dependents`	integer	Dependents in the household, excluding the applicant
`accountYears`	number	Years since the subscription savings account was opened

Example request

curl -X POST https://api.kkuldogu.com/v1/housing-subscription-score -H "content-type: application/json" \
  -d '{"homelessYears":10.5,"dependents":3,"accountYears":7.2}'

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

Example response

{
  "basisYear": 2026,
  "currency": "KRW",
  "disclaimer": "For reference only, not legal, 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
  }
}

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