Splits a Turkish amount into net, VAT and (optionally) withholding: who pays the seller, who remits the withheld VAT.
For invoice lines and checkout totals that have to show KDV dahil / hariç and, when the parties are in a withholding (tevkifat) situation, the split between what the buyer pays the seller and what the buyer remits to the tax office. Rates are 0, 1, 10 and 20 percent. Withholding is a fraction of the VAT (2/10 through 10/10), or a named code from the GİB partial-withholding list. The 2026 threshold (TRY 12,000 gross) is reported and compared with the amount, but applies is always null: whether withholding actually applies depends on the taxpayer status of both parties, which this endpoint does not know. Feeding it a fraction is not a legal opinion.
Credits per call: 1 · Operation id: tr_vat
In the GET form every field is a query parameter; object and array fields are JSON-encoded.
Request
- Base URL: https://api.temsor.com
- URL: https://api.temsor.com/v1/tr/vat
- Auth: one of:
- HTTP bearer
- API key in header x-api-key
Query parameters
The amount to tax. See amountIncludesVat.
If true, amount is the gross (KDV dahil); if false, it is the net/matrah.
Withholding fraction such as "5/10", or a code from the list (reklam, tasima, hurda, isgucu…).
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.