Overview

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

Field	Description
`grossAmount`	Total salary before deductions
`netAmount`	Take-home pay after all deductions
`allowances`	Imputed-income line items (e.g. benefits-in-kind) surfaced by the country engine. Omitted when none apply.
`deductions`	Employee deductions — income tax, social security, etc. Each entry’s `isStatutory` flag indicates whether the deduction is mandated by law.
`employerContributions`	Employer-side costs not deducted from the employee’s pay
`outputCurrency`, `fxRate`	Present 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

	Estimate	Calculate
Endpoint	`POST /v1/tax/estimate`	`POST /v1/tax/calculate`
Person record	Not needed	Required
Best for	Compensation planning, cost modeling, hiring decisions	Payroll processing, year-to-date tracking, compliance
Year-to-date	No	Yes
Country-specific fields	No	Yes (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.

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

Get Started

Workforce Management

Payroll & Compliance

White-Label UI

Platform Integration

Payments

Wallets

Gross to Net

Net to Gross

Response Fields

When to Use Estimate vs. Calculate

Embeddable Widget

Widget Getting Started

Widget Configuration

Next Steps

Tax Engine Integration

API Reference

​Gross to Net

​Net to Gross

​Response Fields

​When to Use Estimate vs. Calculate

​Embeddable Widget

Widget Getting Started

Widget Configuration

​Next Steps

Tax Engine Integration

API Reference

Gross to Net

Net to Gross

Response Fields

When to Use Estimate vs. Calculate

Embeddable Widget

Next Steps