New
The key, field lists and sample requests are provided only to users logged in to the portal, in the guide under My Account → API keys; this page contains no code or keys. An API key requires the professional package (labor claims, actuarial and sentence execution) or the vehicle depreciation package.
Two ways: API and MCP
| Calculation API | AI connection (MCP) | |
|---|---|---|
| Who is it for? | Developer: law office software, case management system, website | Lawyer, expert: by talking to Claude or ChatGPT |
| Code | Required (guide with examples in the portal) | Not required |
| Connection | API key (My Account → API keys) | Add a connector in the assistant, approve with one click in the portal |
| Package | Professional package (vehicle package for vehicles) | Free calculations without a package; 5 trial calculations per module for paid ones |
| Engine, breakdown, report | Same engines; paid calculations are saved to My Reports on both routes | |
AI connection (MCP)
MCP (Model Context Protocol) is the open standard that lets AI assistants use external services as tools. Once connected, the assistant does not try to perform a severance pay, notice pay, actuarial, sentence execution or rent increase calculation itself; it has the Tazminat.com engines perform it and relays the result with its breakdown. The assistant is also given rules: do not calculate amounts yourself, do not guess fault or degree of disability rates, do not change the result.
- Claude: Settings → Connectors → add custom connector →
https://api.tazminat.com/mcp - When you select Connect, the portal opens; approve the connection with your account.
- The connection appears under My Account → API keys with the name “MCP: Claude”; you can remove it at any time.
Details, tool list and fees: AI Connection (MCP).
What is the API for?
Your law office software already holds client and case file information. With the API, you send this information to Tazminat.com, have the calculation performed by engines built to expert standards, and show the step-by-step breakdown and result on your own screen. The calculation is also written to the My Reports list in the portal; PDF, Word, Excel and UDF outputs can be obtained from either side.
Which calculations?
| Calculation | Fee |
|---|---|
| Labor claims (severance pay, notice pay, overtime, national and public holidays, annual leave, wages) | Labor claims package credit |
| Traffic accident — injury and fatal | Actuarial package credit |
| Work accident — injury and fatal | Actuarial package credit |
| İPSD (initial capitalized value and recourse) | Free entitlement, then actuarial package |
| Sentence execution (sentence computation, conditional release, probation) | Sentence execution package credit |
| Additional damages | Free |
| Inheritance shares (statutory share, reserved portion, reduction) | Free |
| Statutory interest | Free |
| Attorney fee (AAÜT) | Free |
| Gross-to-net and net-to-gross wage | Free |
| Vehicle depreciation (step-by-step vehicle selection, valuation with current market data, annulled formula) | Vehicle depreciation package credit |
Key and access
- Log in to the portal (e-mail + password, then an SMS or e-mail code).
- My Account → API keys: create a key. The professional package (labor claims + actuarial + sentence execution) is required; for vehicle depreciation alone, the vehicle depreciation package is sufficient.
- The key is shown only at that moment; it is sent in the HTTP header with every request. If it is lost, a new one is created and the old one is revoked.
- Field names, sample requests and the response structure are in the guide in the same section; the guide becomes available once a key is created.
Use with a key does not affect the portal session: you can work in the portal and use the API at the same time; the single-session rule does not apply to the API.
Fee
There is no separate fee for the API. As in the portal, each paid calculation deducts 1 credit from the relevant module's credits; free calculations (interest, attorney fee, gross-net, inheritance, additional damages) are also free through the API. Creating a key requires the professional package.
Reports and outputs
- Each calculation is written to the My Reports list in the portal with the source "API"; a report name can be given in the request.
- The report document (sections, tables, formatted values) and PDF / Word / Excel / UDF files can also be downloaded from the API.
- PDFs carry a watermark with the user and report number.
Data sets
Data sets such as life tables, disability schedules, the offense catalog, and capitalized value and attorney fee tariffs are not published separately; calculations are performed on the server with this data, and the result is returned as a breakdown (stating the coefficient, table and article used). The selection lists needed for calculations (courts, offense articles, index series) are explained to key holders in the guide and are subject to usage limits. The tables of the free calculation tools on the site (severance pay ceiling, attorney fee, rent increase, deposit interest) are open to everyone.
Usage limits
- There is a per-minute request limit and a daily ceiling on paid calculations per user; when exceeded, the request is rejected and no credit is deducted.
- A separate, lower limit applies to selection list endpoints (they are not for bulk download).
- In the event of unusual use, the key may be temporarily disabled; an e-mail is sent to the account holder.
- Requests do not require a client name; dates, amounts and selections are sufficient for the calculation.
Frequently asked questions
What is the difference between the API and MCP?
The API is for running calculations from your own software with code; MCP works from inside AI assistants such as Claude and ChatGPT, without writing code. Both use the same engines and the same reports. Details: MCP.
Is there a separate fee for the API?
No. Paid calculations are deducted from module credits; free calculations are also free in the API. A key requires the professional package.
How do I get an API key?
Portal login → My Account → API keys. The key is shown once and is sent in the HTTP header with every request.
Where are calculation results stored?
In the My Reports list in the portal; outputs can be obtained from the portal and the API.
Can the data sets be obtained separately?
No; calculations are performed on the server and the result is returned with a breakdown. The tables of the free tools on the site are open to everyone.
Ready to integrate?
For the API, log in to the portal, create a key under My Account → API keys and access the guide. To connect your AI assistant, follow the steps on the MCP page. Write to us with corporate integration questions.
Create API key → Contact us