Türkiye Withholding Tax Calculator: API and MCP

Türkiye Withholding Tax Calculator over REST and MCP: input fields, limits, outputs, one example request and its real answer. Free, no sign-up.

Id: tax.withholding.tr
Version: 1.0.0
Access: Free
Tool page: Türkiye Withholding Tax Calculator
Schema: GET /api/v1/tools/tax.withholding.tr

Input

Field	Type	Constraints	Default	Description
`amount` (required)	number	≥ 0, ≤ 1,000,000,000		Amount (TRY)
`rate`	number	≥ 0, ≤ 50	20	Withholding rate (%) · 20% for rent paid by a business and for self-employment fees, 5% for multi-year construction progress payments (Income Tax Law art. 94). Enter the rate of your payment.
`direction`	string	grossToNet \| netToGross	grossToNet	Direction

Output

Field	Type	Description
`withholding`	number	Withholding tax (TRY)
`gross`	number	Gross amount (TRY)
`net`	number	Net amount (TRY)

Example request

{
  "input": {
    "amount": 20000,
    "rate": 20,
    "direction": "grossToNet"
  },
  "locale": "en"
}

Example answer

{
  "output": {
    "withholding": 4000,
    "gross": 20000,
    "net": 16000
  },
  "steps": [
    {
      "id": "withholding",
      "formula": "withholding = gross amount × 20%",
      "substitution": "withholding = 20,000 × 20%",
      "value": 4000
    },
    {
      "id": "net",
      "formula": "net amount = gross amount − withholding",
      "substitution": "net amount = 20,000 − 4,000",
      "value": 16000
    }
  ],
  "meta": {
    "toolVersion": "1.0.0",
    "locale": "en"
  },
  "citation": {
    "url": "https://hesaplayici.com/en/tax/turkey-withholding-tax-calculator",
    "title": "Türkiye Withholding Tax Calculator"
  }
}