curl --request POST \
--url https://api.cadanapay.com/v1/tax/calculate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"personId": "per_01ABC",
"salary": {
"amount": 4000000,
"currency": "MXN"
},
"additionalAttributes": {
"ytdSalary": 4000000
}
}
'{
"personId": "per_01ABC",
"grossAmount": {
"amount": 1000000,
"currency": "BRL"
},
"netAmount": {
"amount": 761244,
"currency": "BRL"
},
"deductions": [
{
"name": "INSS (Instituto Nacional do Seguro Social)",
"amount": {
"amount": 82839,
"currency": "BRL"
}
},
{
"name": "IRRF (Imposto de Renda Retido na Fonte)",
"amount": {
"amount": 155917,
"currency": "BRL"
}
}
],
"employerContributions": [
{
"name": "FGTS (Fundo de Garantia do Tempo de Serviço)",
"amount": {
"amount": 80000,
"currency": "BRL"
}
}
],
"summary": {
"gross": {
"name": "Gross Salary",
"amount": 1000000,
"calculation": {
"description": "Monthly base salary calculation",
"inputValues": {
"baseSalary": 1000000
},
"formula": "baseSalary",
"steps": [
"Base salary amount: R$10000.00"
]
}
},
"deductions": [
{
"name": "INSS (Instituto Nacional do Seguro Social)",
"amount": 82839,
"calculation": {
"description": "Brazilian Social Security contribution based on 2024 INSS tables",
"inputValues": {
"grossSalary": 10000,
"bracket1Rate": 0.075,
"bracket2Rate": 0.09,
"bracket3Rate": 0.12,
"bracket4Rate": 0.14,
"bracket1Limit": 1320,
"bracket2Limit": 2571.29,
"bracket3Limit": 3856.94,
"bracket4Limit": 7507.49
},
"formula": "Progressive rate calculation based on salary brackets",
"steps": [
"Bracket 1: 1320.00 * 7.5% = 99.00",
"Bracket 2: (2571.29 - 1320.00) * 9% = 112.62",
"Bracket 3: (3856.94 - 2571.29) * 12% = 154.28",
"Bracket 4: (7507.49 - 3856.94) * 14% = 462.49",
"Total INSS contribution: R$828.39"
]
}
},
{
"name": "IRRF (Imposto de Renda Retido na Fonte)",
"amount": 155917,
"calculation": {
"description": "Brazilian Income Tax calculation based on 2024 rates",
"inputValues": {
"grossSalary": 10000,
"inssDeduction": 828.39,
"baseCalculation": 9171.61,
"dependentsDeduction": 0,
"irrfRate": 0.275,
"deduction": 869.36
},
"formula": "(baseCalculation * irrfRate) - deduction",
"steps": [
"Gross salary: R$10000.00",
"INSS deduction: R$828.39",
"Base for IRRF: R$9171.61",
"Apply 27.5% rate: R$9171.61 * 0.275 = R$2522.19",
"Deduction amount: R$869.36",
"Final IRRF: R$1559.17"
]
}
}
],
"net": {
"name": "Net Salary",
"amount": 761244,
"calculation": {
"description": "Final take-home pay calculation",
"inputValues": {
"grossSalary": 10000,
"inssDeduction": 828.39,
"irrfDeduction": 1559.17
},
"formula": "grossSalary - inssDeduction - irrfDeduction",
"steps": [
"Gross salary: R$10000.00",
"INSS deduction: R$828.39",
"IRRF deduction: R$1559.17",
"Net salary: R$7612.44"
]
}
},
"employerContributions": [
{
"name": "FGTS (Fundo de Garantia do Tempo de Serviço)",
"amount": 80000,
"calculation": {
"description": "Employer's FGTS contribution calculation",
"inputValues": {
"grossSalary": 10000,
"fgtsRate": 0.08
},
"formula": "grossSalary * fgtsRate",
"steps": [
"Calculate 8% FGTS: R$10000.00 * 8% = R$800.00"
]
}
}
]
}
}Calculate taxes for a person. The person’s address determines the jurisdiction, and their compensation and tax profile provide calculation inputs.
curl --request POST \
--url https://api.cadanapay.com/v1/tax/calculate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"personId": "per_01ABC",
"salary": {
"amount": 4000000,
"currency": "MXN"
},
"additionalAttributes": {
"ytdSalary": 4000000
}
}
'{
"personId": "per_01ABC",
"grossAmount": {
"amount": 1000000,
"currency": "BRL"
},
"netAmount": {
"amount": 761244,
"currency": "BRL"
},
"deductions": [
{
"name": "INSS (Instituto Nacional do Seguro Social)",
"amount": {
"amount": 82839,
"currency": "BRL"
}
},
{
"name": "IRRF (Imposto de Renda Retido na Fonte)",
"amount": {
"amount": 155917,
"currency": "BRL"
}
}
],
"employerContributions": [
{
"name": "FGTS (Fundo de Garantia do Tempo de Serviço)",
"amount": {
"amount": 80000,
"currency": "BRL"
}
}
],
"summary": {
"gross": {
"name": "Gross Salary",
"amount": 1000000,
"calculation": {
"description": "Monthly base salary calculation",
"inputValues": {
"baseSalary": 1000000
},
"formula": "baseSalary",
"steps": [
"Base salary amount: R$10000.00"
]
}
},
"deductions": [
{
"name": "INSS (Instituto Nacional do Seguro Social)",
"amount": 82839,
"calculation": {
"description": "Brazilian Social Security contribution based on 2024 INSS tables",
"inputValues": {
"grossSalary": 10000,
"bracket1Rate": 0.075,
"bracket2Rate": 0.09,
"bracket3Rate": 0.12,
"bracket4Rate": 0.14,
"bracket1Limit": 1320,
"bracket2Limit": 2571.29,
"bracket3Limit": 3856.94,
"bracket4Limit": 7507.49
},
"formula": "Progressive rate calculation based on salary brackets",
"steps": [
"Bracket 1: 1320.00 * 7.5% = 99.00",
"Bracket 2: (2571.29 - 1320.00) * 9% = 112.62",
"Bracket 3: (3856.94 - 2571.29) * 12% = 154.28",
"Bracket 4: (7507.49 - 3856.94) * 14% = 462.49",
"Total INSS contribution: R$828.39"
]
}
},
{
"name": "IRRF (Imposto de Renda Retido na Fonte)",
"amount": 155917,
"calculation": {
"description": "Brazilian Income Tax calculation based on 2024 rates",
"inputValues": {
"grossSalary": 10000,
"inssDeduction": 828.39,
"baseCalculation": 9171.61,
"dependentsDeduction": 0,
"irrfRate": 0.275,
"deduction": 869.36
},
"formula": "(baseCalculation * irrfRate) - deduction",
"steps": [
"Gross salary: R$10000.00",
"INSS deduction: R$828.39",
"Base for IRRF: R$9171.61",
"Apply 27.5% rate: R$9171.61 * 0.275 = R$2522.19",
"Deduction amount: R$869.36",
"Final IRRF: R$1559.17"
]
}
}
],
"net": {
"name": "Net Salary",
"amount": 761244,
"calculation": {
"description": "Final take-home pay calculation",
"inputValues": {
"grossSalary": 10000,
"inssDeduction": 828.39,
"irrfDeduction": 1559.17
},
"formula": "grossSalary - inssDeduction - irrfDeduction",
"steps": [
"Gross salary: R$10000.00",
"INSS deduction: R$828.39",
"IRRF deduction: R$1559.17",
"Net salary: R$7612.44"
]
}
},
"employerContributions": [
{
"name": "FGTS (Fundo de Garantia do Tempo de Serviço)",
"amount": 80000,
"calculation": {
"description": "Employer's FGTS contribution calculation",
"inputValues": {
"grossSalary": 10000,
"fgtsRate": 0.08
},
"formula": "grossSalary * fgtsRate",
"steps": [
"Calculate 8% FGTS: R$10000.00 * 8% = R$800.00"
]
}
}
]
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
ID of the person to calculate taxes for. The person's address determines the jurisdiction, and their compensation and tax profile provide calculation inputs.
Show child attributes
Additional attributes for the country-specific tax calculation