Quickstart

This page gets you your first result in a few minutes, with no sign-up or key. All endpoints are under https://api.mirac-ozdemir.com and return JSON.

Find the tool. Every tool has a permanent key (e.g. kdv). You can browse the tool catalog or search:
Terminal window
```
curl "https://api.mirac-ozdemir.com/v1/public/search?locale=tr&q=kdv&pageSize=3"
```
Every record in the response contains key, title, category and path.
Read the definition. Input fields, outputs, labels and applicable rates are inside the definition:
Terminal window
```
curl "https://api.mirac-ozdemir.com/v1/public/tools/by-key/kdv?locale=tr"
```
inputSchema.fields tells you which values you need to send (amount: decimal, mode: exclusive | inclusive, vatRateOption: standard | reduced10 | reduced1).

Calculate. Send the values in inputs. Decimals must be strings:

curl -X POST "https://api.mirac-ozdemir.com/v1/public/tools/by-key/kdv/calculate" \
  -H "Content-Type: application/json" \
  -d '{"inputs":{"amount":"1000","mode":"exclusive","vatRateOption":"standard"}}'

{
  "data": {
    "result": { "net": "1000.00", "vat": "200.00", "gross": "1200.00" },
    "breakdown": [
      { "key": "net", "value": "1000.00", "format": "money", "scale": 2, "currency": "TRY" },
      { "key": "vat", "value": "200.00", "format": "money", "scale": 2, "currency": "TRY" },
      { "key": "gross", "value": "1200.00", "format": "money", "scale": 2, "currency": "TRY" }
    ]
  },
  "meta": {
    "toolVersion": 1,
    "asOf": "2026-10-11",
    "rates": [{ "binding": "vatRate", "key": "tr.vat.standard", "value": "20", "effectiveFrom": "2023-07-10", "effectiveTo": null }]
  }
}

<div data-mo-tool="kdv" data-locale="tr"></div>
<script src="https://api.mirac-ozdemir.com/widget.js" async></script>

The widget shows the calculator inside an iframe, adjusts its height to the content and passes results to your page as the mo:result event. Details: Widget overview.

What’s next

Core conceptskey, asOf, version and decimal rules.

CalculationAll request and response fields.

ErrorsError codes and retrying.

PlaygroundTry requests in the browser.

Quickstart

One minute with the widget

What’s next