Türkiye Property Tax Calculator: API and MCP

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

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

Input

Field	Type	Constraints	Default	Description
`year` (required)	integer	≥ 2,005, ≤ 2,100		Tax year
`mode`	string	fromValue \| fromPreviousValue	fromValue	Calculation
`value`	number	> 0, ≤ 100,000,000,000		Tax value (TRY) · The year’s value on the municipality’s property tax notice or on e-Devlet.
`previousValue`	number	> 0, ≤ 100,000,000,000		Last year’s tax value (TRY) · The calculator raises last year’s value by the year’s increase. Not for a general valuation year.
`propertyType`	string	home \| otherBuilding \| plot \| land	home	Property type
`location`	string	metropolitan \| other	metropolitan	Location
`relief`	string	none \| singleHome	none	Zero rate

Output

Field	Type	Description
`tax`	number	Yearly property tax (TRY)
`installment`	number	Each installment (2 in total) (TRY)
`value`	number	Tax value (TRY)
`rate`	number	Rate applied (‰)
`valueIncrease`	number	Value increase of the year (%)

Example request

curl -X POST https://hesaplayici.com/api/v1/tools/housing.property-tax.tr/execute \
  -H 'Content-Type: application/json' \
  -d '{"input":{"year":2026,"mode":"fromValue","value":2000000,"propertyType":"home","location":"metropolitan","relief":"none"},"locale":"en"}'

Example answer

{
  "output": {
    "tax": 4000,
    "installment": 2000,
    "value": 2000000,
    "rate": 2,
    "valueIncrease": 0
  },
  "steps": [
    {
      "id": "tax",
      "formula": "yearly property tax = tax value × rate",
      "substitution": "yearly property tax = 2,000,000.00 × 2 per mille",
      "value": 4000
    },
    {
      "id": "installment",
      "formula": "installment = yearly property tax / 2",
      "substitution": "installment = 4,000.00 / 2",
      "value": 2000
    }
  ],
  "notes": [],
  "meta": {
    "toolVersion": "1.0.0",
    "dataVersion": "2026-01-01",
    "locale": "en"
  },
  "citation": {
    "url": "https://hesaplayici.com/en/housing/turkey-property-tax-calculator",
    "title": "Türkiye Property Tax Calculator"
  }
}