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)", "amount": { "amount": 680000, "currency": "MXN" } },
    { "name": "IMSS Employee Contribution", "amount": { "amount": 270000, "currency": "MXN" } }
  ],
  "employerContributions": [
    { "name": "IMSS Employer Contribution", "amount": { "amount": 840000, "currency": "MXN" } },
    { "name": "INFONAVIT (5%)", "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
deductionsEmployee deductions — income tax, social security, etc.
employerContributionsEmployer-side costs not deducted from the employee’s pay
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