Skip to main content
The Employment Cost Calculator gives you instant salary estimates without creating a person record — one API call with a country code and salary amount. Use it for compensation planning, cost modeling, and hiring decisions.

​
Gross to Net

Estimate take-home pay from a gross salary: Response: 
{
  "grossAmount": { "amount": 4000000, "currency": "MXN" },
  "netAmount": { "amount": 3050000, "currency": "MXN" },
  "deductions": [
    { "name": "ISR (Impuesto Sobre la Renta)", "isStatutory": true, "amount": { "amount": 680000, "currency": "MXN" } },
    { "name": "IMSS Employee Contribution", "isStatutory": true, "amount": { "amount": 270000, "currency": "MXN" } }
  ],
  "employerContributions": [
    { "name": "IMSS Employer Contribution", "isStatutory": true, "amount": { "amount": 840000, "currency": "MXN" } },
    { "name": "INFONAVIT (5%)", "isStatutory": true, "amount": { "amount": 200000, "currency": "MXN" } }
  ]
}

​
Net to Gross

Calculate the gross salary needed to achieve a target take-home amount:

​
Response Fields

FieldDescription
grossAmountTotal salary before deductions
netAmountTake-home pay after all deductions
allowancesImputed-income line items (e.g. benefits-in-kind) surfaced by the country engine. Omitted when none apply.
deductionsEmployee deductions — income tax, social security, etc. Each entry’s isStatutory flag indicates whether the deduction is mandated by law.
employerContributionsEmployer-side costs not deducted from the employee’s pay
outputCurrency, fxRatePresent only when the request passed outputCurrency — echoes the requested currency and the rate applied.
Amounts are in the smallest currency unit (e.g., centavos for MXN). An amount of 4000000 in MXN means $40,000.00 MXN.

​
When to Use Estimate vs. Calculate

EstimateCalculate
EndpointPOST /v1/tax/estimatePOST /v1/tax/calculate
Person recordNot neededRequired
Best forCompensation planning, cost modeling, hiring decisionsPayroll processing, year-to-date tracking, compliance
Year-to-dateNoYes
Country-specific fieldsNoYes (marital status, dependents, etc.)
For payroll-grade calculations with year-to-date tracking and country-specific tax profiles, use the Tax Engine with a person record.

​
Embeddable Widget

Need a visual calculator for your website? The Gross-to-Net Salary Calculator widget wraps this same API in an embeddable, themeable UI component that works in any website or CMS.

Widget Getting Started

Add the calculator to your site with a single script tag

Widget Configuration

Customize countries, periods, labels, and theming

​
Next Steps

Tax Engine Integration

Full tax calculations with person records and year-to-date tracking

API Reference

Full endpoint documentation