Türkiye Rental Income Tax Calculator: API and MCP

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

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

Input

Field	Type	Constraints	Default	Description
`year` (required)	integer	≥ 2,005, ≤ 2,100		Year the rent was collected · The return is filed in March of the next year: 2025 rent in March 2026.
`residential`	number	≥ 0, ≤ 100,000,000,000	0	Yearly residential rent (TRY) · Gross rent collected in the year, all homes together. For a shared home, your share only.
`workplace`	number	≥ 0, ≤ 100,000,000,000	0	Withheld workplace rent (gross) (TRY) · Yearly gross rent of workplaces and other property on which the tenant withheld income tax.
`method`	string	flat \| actual	flat	Expense method · The flat expense needs no receipts: 15% of the rent after the exemption counts as expenses (25% to 2016). Real expenses deduct your documented costs; when they are more, the tax is lower.
`expenses`	number	≥ 0, ≤ 100,000,000,000		Yearly real expenses (TRY) · Total documented expenses of the rented property. The calculator removes the share of the exempt rent.
`otherRent`	number	≥ 0, ≤ 100,000,000,000	0	Rent with no withholding (TRY) · Rent with no withholding and no exemption: for example a workplace rented to a simple-method trader or to a private person.
`otherIncome`	number	≥ 0, ≤ 100,000,000,000	0	Other gross income (TRY) · Gross wages, interest, dividends and other income of the year, declared or not. Counts toward the income test of the residential exemption.
`business`	string	no \| yes	no	Do you declare a commercial, agricultural or professional income?

Output

Field	Type	Description
`payable`	number	Income tax to pay (TRY)
`tax`	number	Income tax calculated (TRY)
`withholdingCredit`	number	Withholding credited (TRY)
`refund`	number	Tax refunded (TRY)
`taxableIncome`	number	Taxable income (TRY)
`declaredRent`	number	Rent on the return (gross) (TRY)
`exemption`	number	Residential rent exemption (TRY)
`expenseDeduction`	number	Expenses deducted (TRY)
`expenseExcess`	number	Excess expenses (to later years) (TRY)
`returnRequired`	boolean	You must file a yearly income tax return for the rent.
`noReturn`	boolean	You do not need to file a return for this rent.
`workplaceFinal`	boolean	The withheld rent is under the filing limit: the withholding is the final tax and the rent stays off the return.
`exemptionIncomeOver`	boolean	No residential exemption: the gross income total passes the third bracket of the wage tariff (art. 21).
`exemptionBusiness`	boolean	No residential exemption: a person who declares a commercial, agricultural or professional income cannot use it (art. 21).

Example request

curl -X POST https://hesaplayici.com/api/v1/tools/tax.rental-income.tr/execute \
  -H 'Content-Type: application/json' \
  -d '{"input":{"year":2025,"residential":360000,"workplace":0,"method":"flat","otherRent":0,"otherIncome":0,"business":"no"},"locale":"en"}'

Example answer

{
  "output": {
    "payable": 45310,
    "tax": 45310,
    "withholdingCredit": 0,
    "refund": 0,
    "taxableIncome": 266050,
    "declaredRent": 360000,
    "exemption": 47000,
    "expenseDeduction": 46950,
    "expenseExcess": 0,
    "returnRequired": true,
    "noReturn": false,
    "workplaceFinal": false,
    "exemptionIncomeOver": false,
    "exemptionBusiness": false
  },
  "steps": [
    {
      "id": "incomeTotal",
      "formula": "income total = residential rent + withheld rent + rent with no withholding + other income",
      "substitution": "income total = 360,000.00 + 0.00 + 0.00 + 0.00 (limit 1,200,000.00)",
      "value": 360000,
      "unit": "TRY"
    },
    {
      "id": "exemption",
      "formula": "exemption = min(residential rent, exemption amount)",
      "substitution": "exemption = min(360,000.00, 47,000.00)",
      "value": 47000,
      "unit": "TRY"
    },
    {
      "id": "declaredRent",
      "formula": "rent on the return = residential rent + withheld rent + rent with no withholding",
      "substitution": "rent on the return = 360,000.00 + 0.00 + 0.00",
      "value": 360000
    },
    {
      "id": "expenseDeduction",
      "formula": "expenses = (rent on the return − exemption) × 15%",
      "substitution": "expenses = 313,000.00 × 15%",
      "value": 46950
    },
    {
      "id": "taxableIncome",
      "formula": "taxable income = rent on the return − exemption − expenses",
      "substitution": "taxable income = 360,000.00 − 47,000.00 − 46,950.00",
      "value": 266050
    },
    {
      "id": "tax",
      "formula": "income tax = Σ bracket",
      "substitution": "income tax = 158,000.00 × 15% + 108,050.00 × 20%",
      "value": 45310
    }
  ],
  "notes": [],
  "meta": {
    "toolVersion": "1.0.0",
    "dataVersion": "2025-01-01",
    "locale": "en"
  },
  "citation": {
    "url": "https://hesaplayici.com/en/tax/turkey-rental-income-tax-calculator",
    "title": "Türkiye Rental Income Tax Calculator"
  }
}