Calculate Tax
POST /api/v1/tax/calculate
Calculate estimated tax liability for a given income and country
Request Body
Section titled “Request Body ”object
Country for tax calculation
Example
PTobject
Annual salary income
Example
60000Annual freelance/self-employment income
Example
20000Annual dividend income
Example
5000Annual capital gains (can be negative)
Example
10000Annual rental income
Other taxable income
object
Pension contributions
Health insurance premiums
Education expenses
Housing deductions (mortgage interest, etc.)
Charitable donations
Other deductions
ID of special tax program to apply
Example
nhr-portugalTax filing status
Number of dependents
Responses
Section titled “ Responses ”Tax calculation result
object
object
Country name
Example
PortugalTotal gross income
Example
95000Taxable income after deductions
Example
85000Total deductions applied
Example
10000object
Income tax amount
Example
25000Capital gains tax amount
Example
2800Dividend tax amount
Example
1400Social security contributions
Example
5000Other applicable taxes
Total tax liability
Example
34200Effective tax rate (%)
Example
36Net income after taxes
Example
60800Name of special program applied
Important notes and disclaimers
Comparison with standard taxation
object
Tax without special programs
Savings from special program
object
Legal disclaimer
Example
This is an estimate only. Consult a tax professional for accurate advice.Validation error
object
Always false for error responses
Error type
Example
Validation errorMachine-readable error code
Example
VALIDATION_ERRORDetailed validation errors
object
Path to the invalid field
Example
currentAgeError message
Example
Must be between 18 and 100