Türkiye Stamp Duty Calculator: API and MCP

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

Id: tax.stamp-duty.tr
Version: 1.0.0
Access: Free
Tool page: Türkiye Stamp Duty Calculator
Schema: GET /api/v1/tools/tax.stamp-duty.tr

Input

Field	Type	Constraints	Default	Description
`date` (required)	string			Date of the document · The rates and the maximum per document of that year apply.
`documentType`	string	contract \| lease \| guarantee \| termination \| decision \| tender \| wageReceipt	contract	Document type
`amount` (required)	number	≥ 0, ≤ 50,000,000,000		Amount on the document (TRY) · For a lease, enter the total rent of the contract period (monthly rent × number of months).

Output

Field	Type	Description
`stampDuty`	number	Stamp duty (TRY)
`perMille`	number	Rate (‰)
`uncapped`	number	Amount × rate (TRY)
`maxPerPaper`	number	Maximum per document (TRY)
`capped`	boolean	The maximum per document limited the duty.

Example request

{
  "input": {
    "date": "2026-03-02",
    "documentType": "contract",
    "amount": 1000000
  },
  "locale": "en"
}

Example answer

{
  "output": {
    "stampDuty": 9480,
    "perMille": 9.48,
    "uncapped": 9480,
    "maxPerPaper": 29115961.1,
    "capped": false
  },
  "steps": [
    {
      "id": "uncapped",
      "formula": "duty before the cap = amount × 9.48 per mille",
      "substitution": "duty before the cap = 1,000,000 × 9.48 per mille",
      "value": 9480
    },
    {
      "id": "stampDuty",
      "formula": "stamp duty = min(duty before the cap; maximum)",
      "substitution": "stamp duty = min(9,480; 29,115,961.1)",
      "value": 9480
    }
  ],
  "meta": {
    "toolVersion": "1.0.0",
    "dataVersion": "2026-01-01",
    "locale": "en"
  },
  "citation": {
    "url": "https://hesaplayici.com/en/tax/turkey-stamp-duty-calculator",
    "title": "Türkiye Stamp Duty Calculator"
  }
}