Türkiye Income Tax Calculator: API and MCP

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

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

Input

Field	Type	Constraints	Default	Description
`income` (required)	number	≥ 0, ≤ 1,000,000,000,000		Annual taxable income (TRY)
`year` (required)	integer	≥ 2,000, ≤ 2,100		Income year
`kind`	string	nonWage \| wage	nonWage	Type of income

Output

Field	Type	Description
`tax`	number	Income tax (TRY)
`afterTax`	number	Income after tax (TRY)
`effectiveRate`	number	Effective tax rate (%)
`marginalRate`	number	Marginal tax rate (%)
`brackets`	array	Tax by bracket

Example request

{
  "input": {
    "income": 1000000,
    "year": 2026,
    "kind": "nonWage"
  },
  "locale": "en"
}

Example answer

{
  "output": {
    "tax": 232500,
    "afterTax": 767500,
    "effectiveRate": 23.25,
    "marginalRate": 27,
    "brackets": [
      {
        "rate": 15,
        "from": 0,
        "taxable": 190000,
        "tax": 28500
      },
      {
        "rate": 20,
        "from": 190000,
        "taxable": 210000,
        "tax": 42000
      },
      {
        "rate": 27,
        "from": 400000,
        "taxable": 600000,
        "tax": 162000
      }
    ]
  },
  "steps": [
    {
      "id": "bracket1",
      "formula": "bracket 1 = taxable income × 15%",
      "substitution": "bracket 1 = 190,000 × 15%",
      "value": 28500
    },
    {
      "id": "bracket2",
      "formula": "bracket 2 = taxable income × 20%",
      "substitution": "bracket 2 = 210,000 × 20%",
      "value": 42000
    },
    {
      "id": "bracket3",
      "formula": "bracket 3 = taxable income × 27%",
      "substitution": "bracket 3 = 600,000 × 27%",
      "value": 162000
    },
    {
      "id": "tax",
      "formula": "income tax = Σ bracket",
      "substitution": "income tax = 28,500 + 42,000 + 162,000",
      "value": 232500
    },
    {
      "id": "effectiveRate",
      "formula": "effective rate = income tax / taxable income × 100",
      "substitution": "effective rate = 232,500 / 1,000,000 × 100",
      "value": 23.25,
      "unit": "%"
    }
  ],
  "meta": {
    "toolVersion": "1.0.0",
    "dataVersion": "2026-01-01",
    "locale": "en"
  },
  "citation": {
    "url": "https://hesaplayici.com/en/tax/turkey-income-tax-calculator",
    "title": "Türkiye Income Tax Calculator"
  }
}