---
title: "Preview jurisdiction tax amounts"
method: POST
path: "/api/v1/br/tax/preview"
tags: ["Tax"]
---

# Preview jurisdiction tax amounts

`POST /api/v1/br/tax/preview`

Computes disbursement IOF tax amounts using the active compiled jurisdiction profile without persisting data.

## Request body

- TaxPreviewHumaBody
  - `disbursementDate` string, date-time, required — Disbursement date (RFC3339).
  - `finalDueDate` string, date-time, required — Final due date (RFC3339).
  - `grossAmount` string, required — Gross disbursement amount in major currency units (e.g. "100000.00").
  - `jurisdictionCode` string, required — ISO 3166-1 alpha-2 jurisdiction code (e.g. "BR").
  - `netDeliveredAmount` string — Optional net delivered amount in major currency units.
  - `taxRegime` string, required — Tax regime selector understood by the jurisdiction tax engine.

## Response `200`

OK

- TaxPreviewEnvelopeResponse
  - `data` TaxPreviewResponse, required
    - `cofins` string, required — COFINS contribution amount, decimal string in major currency units (scale 2).
    - `grossAmount` string, required — Gross disbursement amount before tax, decimal string in major currency units (scale 2).
    - `iofAdditional` string, required — Additional fixed-rate IOF component, decimal string in major currency units (scale 2).
    - `iofDaily` string, required — Daily IOF component, decimal string in major currency units (scale 2).
    - `jurisdictionCode` string, required — ISO 3166-1 alpha-2 jurisdiction code (e.g. "BR").
    - `netDeliveredAmount` string, required — Net amount delivered to the borrower after tax deduction, decimal string in major currency units (scale 2).
    - `pis` string, required — PIS contribution amount, decimal string in major currency units (scale 2).
    - `profileVersion` string, required — Compiled jurisdiction profile version used to compute the preview (e.g. "1.0.0").
    - `rateTableSnapshotId` string, required — Identifier of the rate-table snapshot whose rates produced these amounts.
    - `taxRegime` string, required — Tax regime selector applied by the jurisdiction tax engine.
    - `totalIof` string, required — Sum of daily and additional IOF, decimal string in major currency units (scale 2).
    - `totalTax` string, required — Total tax (IOF + PIS + COFINS), decimal string in major currency units (scale 2).

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)