← Market

Year End Tax Batch

South Korea year-end tax settlement estimate for up to 100 employees in one call: refund or additional tax for each employee from salary, dependents, card spending and the main deductions, with totals. Same calculation as year-end-tax-settlement, without the per-employee breakdown.

POST https://api.kkuldogu.com/v1/year-end-tax-batch

0.02 USDC on Base · payTo 0xead5ee9125c8fd7224195f1e17bc628fd385d1d8

Status: verified · payable

Operator badge: embed this endpoint's live status badge — it reads "Verified Payable" only while the probe record backs it.

Settlement: direct to the seller's payTo — 0% HIVE402 take

Payment routes

Base · 0.02 USDC · payTo 0xead5ee9125c8fd7224195f1e17bc628fd385d1d8 · via cdp · settles direct
{
  "employees": [
    {
      "creditCard": 15000000,
      "debitCash": 5000000,
      "grossSalary": 50000000,
      "id": "kim"
    },
    {
      "children": 1,
      "children8to20": 1,
      "dependents": 3,
      "grossSalary": 80000000,
      "id": "lee",
      "pensionSavings": 6000000
    }
  ]
}
{
  "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.",
  "input": {
    "employees": [
      {
        "creditCard": 15000000,
        "debitCash": 5000000,
        "grossSalary": 50000000,
        "id": "kim"
      },
      {
        "children": 1,
        "children8to20": 1,
        "dependents": 3,
        "grossSalary": 80000000,
        "id": "lee",
        "pensionSavings": 6000000
      }
    ]
  },
  "result": {
    "additionalPaymentCount": 1,
    "employees": [
      {
        "amount": 110350,
        "effectiveRatePct": 5.5,
        "finalIncomeTax": 2507520,
        "id": "kim",
        "incomeTaxAlreadyWithheld": 2607840,
        "localIncomeTax": 250750,
        "method": "itemized_special_deductions",
        "outcome": "refund",
        "withheldIsEstimate": true
      },
      {
        "amount": 174090,
        "effectiveRatePct": 7.9,
        "finalIncomeTax": 5734790,
        "id": "lee",
        "incomeTaxAlreadyWithheld": 5576520,
        "localIncomeTax": 573470,
        "method": "itemized_special_deductions",
        "outcome": "additional_payment",
        "withheldIsEstimate": true
      }
    ],
    "headcount": 2,
    "refundCount": 1,
    "totals": {
      "additionalPayment": 174090,
      "finalIncomeTax": 8242310,
      "refund": 110350
    }
  },
  "source": "https://kkuldogu.com",
  "tool": "year-end-tax-batch"
}

Script Master Labs LLC · SDVOSB · Kinston, NC · Terms · Refunds · Privacy · Contact

SML network: ScriptMasterLabs — the main site · SML Dual Market — the human storefront · VA Ratings — VA disability ratings, free for veterans

Agent intel trust badge

Trust score61 / 100 · breakdown
Probe uptime (30d)100.0% over 1 probes · daily
Avg 402 latency1855 ms
Paid calls (30d, on-chain)0 calls · 0 buyers
Facilitator-reported (30d)2 calls · 1 payers (CDP Bazaar)

How to call

POST https://api.kkuldogu.com/v1/year-end-tax-batch · input in body · spec from live-challenge

Input schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "employees": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "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)"
          },
          "id": {
            "type": "string",
            "maxLength": 64,
            "description": "Your identifier, echoed back"
          }
        },
        "required": [
          "grossSalary"
        ],
        "additionalProperties": false
      },
      "description": "Employees, 1-100"
    }
  },
  "required": [
    "employees"
  ],
  "additionalProperties": false
}
Output schema
{
  "type": "object"
}
curl -i -X POST 'https://api.kkuldogu.com/v1/year-end-tax-batch' \
  -H 'content-type: application/json' -d '{"employees":[{"id":"kim","grossSalary":50000000,"creditCard":15000000,"debitCash":5000000},{"id":"lee","grossSalary":80000000,"dependents":3,"children":1,"children8to20":1,"pensionSavings":6000000}]}'

Agents: POST https://hive402.scriptmasterlabs.com/mcp → route_task / proxy_call · SDK /sdk/hive402.mjs

Try it (your wallet signs; HIVE402 never holds funds)