APIs › Business & Financial Calculators › Configurable Tax Calculator

Configurable Tax Calculator

Applies caller-defined tax rules — inclusive or exclusive, compound or parallel, per-line or document level — showing each rule's contribution.

POST /v1/business/configurable-tax $0.005 per call

Specification

Endpoint

POST /v1/business/configurable-tax

Price

$0.005 per call · tier basic_data

Payment

x402 on X Layer (chain 196) · settled in USDG or USDT0 · schemes exact, aggr_deferred

Data source

Deterministic decimal arithmetic on caller-supplied input

Timeout

15 seconds

Max request

256 KB

Version

1.0.0

Calling it

The first call returns a 402 with the payment challenge. Retry with a signed authorisation in the X-PAYMENT header — see the payment guide for the exact shape.

curl -i -X POST "https://api.dana-edu.pp.ua/v1/business/configurable-tax" \
  -H "content-type: application/json" \
  -d '{ ... }'

Response

Real output, captured by running this endpoint at build time — not written by hand. Volatile fields such as timestamps are elided. Captured 2026-07-30.

{
  "base_amount": "1000.00",
  "rules_applied": [
    {
      "name": "VAT",
      "rate_percent": "15",
      "application": "parallel",
      "inclusive": false,
      "base": "1000.00",
      "tax": "150.00",
      "running_total": "1150.00"
    },
    {
      "name": "Municipal levy",
      "rate_percent": "2",
      "application": "compound",
      "inclusive": false,
      "base": "1150.00",
      "tax": "23.00",
      "running_total": "1173.00"
    }
  ],
  "total_tax": "173.00",
  "total_with_tax": "1173.00",
  "extracted_inclusive_tax": "0.00",
  "effective_rate_percent": "17.3000",
  "rounding": {
    "mode": "half_up",
    "decimal_places": 2
  }
}

Every response is wrapped in the same envelope: data plus warnings, sources, confidence, informational_only and a measured processing_ms. See the envelope reference.

Related endpoints