ToolsAPI

NetSalary APIv1

Net take-home pay & total employer cost for 18 European countries — one REST call

Get your free API key

Pricing

Start free, upgrade when your volume grows.

Free

€0 forever

100 calls / month

All 18 countries
Net pay + employer cost
Tax bracket data
Live exchange rates

Get a key

Integrate in minutes

One request in, a full salary breakdown out. No SDK required.

curl -X POST https://netsalary.app/api/v1/calculate \
  -H "Authorization: Bearer nsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"country":"de","gross":5000,"period":"monthly"}'

Endpoints

Nine endpoints: calculations, tax data and market context.

POST/api/v1/calculate

Net pay, employer cost & itemized breakdown for one country

POST/api/v1/compareStarter+

The same calculation across multiple countries at once

POST/api/v1/reverseStarter+

Desired net in, required gross out — with the full breakdown

GET/api/v1/countries

Supported countries & data freshness

GET/api/v1/brackets/:country

Tax brackets & social contribution rates

GET/api/v1/rates

Live EUR exchange rates for all supported currencies

GET/api/v1/holidays/:countryStarter+

Public bank holidays per country and year

GET/api/v1/percentiles/:countryStarter+

Where a salary sits in a country's distribution (p10–p99)

GET/api/v1/cost-of-living/:countryStarter+

Rent, groceries and purchasing-power indices per country

Documentation

Everything you need to integrate: authentication, parameters and error handling.

Authentication

Send your API key as a Bearer token in the Authorization header. Create and manage keys in the dashboard. /developers/keys

Authorization: Bearer nsk_live_…

Request parameters

Body fields for POST /api/v1/calculate and /api/v1/compare.

countrystringrequired

Two-letter country code, e.g. "de"

countriesstring[]optional

Array of country codes (/compare only, replaces country)

grossnumberrequired

Gross salary in the country's local currency

periodstringrequired

Period of the gross amount: "monthly" or "yearly"

yearnumberoptional

Tax year: 2025 or 2026 (default 2026)

Response fields

netnumber

Net take-home pay per period

employerCostnumber

Total cost to employ: gross + employer contributions

effectiveRatenumber

Effective tax rate in percent

currencystring

Local currency of all amounts

breakdownarray

Itemized tax lines: income tax, social contributions and more

Reverse calculation

POST/api/v1/reverseStarter+

Send the net salary a candidate wants; get back the gross you need to offer and what it costs you as an employer.

POST /api/v1/reverse  { "country": "de", "net": 3500, "period": "monthly" }
→ { "requiredGross": 5160, "employerCost": 6251, … }

Bank holidays

GET /api/v1/holidays/:countryStarter+

Public holidays with localized names. Query params: year (2026 or 2027) and lang (11 languages).

GET /api/v1/holidays/de?year=2026&lang=de
→ { "count": 11, "holidays": [ { "date": "2026-01-01", "name": "Neujahr" }, … ] }

Errors

401

Missing or invalid API key

403

Endpoint not available on your tier

422

Validation failed: unsupported country, bad amount or year

429

Monthly quota exceeded

A salary calculation API built for payroll, EOR and finance teams

NetSalary API turns gross salaries into net take-home pay and total employer cost using the 2026 tax rules of 18 European countries — income tax brackets, social contributions and employer charges included. It is the same engine behind the NetSalary calculator, exposed as a simple REST API for payroll software, employer-of-record platforms, relocation tools and HR systems.

What teams build with it

Payroll & accounting

Show employees accurate net pay and finance teams the true cost of every hire before the payroll run.

EOR & global hiring

Quote total employment cost across 18 countries in one request when pricing international offers.

Relocation & mobility

Compare take-home pay between countries so candidates see what an offer is really worth after tax.

Job boards & fintech

Enrich listings and financial products with net salary estimates and public holiday calendars.

Frequently asked questions

What is a net salary API?

A REST service that converts gross salary into net take-home pay. You send a country, a gross amount and a period; the API returns net pay, total employer cost, the effective tax rate and an itemized breakdown of income tax and social contributions.

Which countries does the salary API support?

Eighteen countries: Germany, United Kingdom, Netherlands, Spain, Poland, Switzerland, Ireland, Portugal, Sweden, Norway, Finland, Estonia, Latvia, Lithuania, Austria, Belgium, Brazil and the UAE — with 2025 and 2026 tax rules.

How accurate are the calculations?

Each country's rules are maintained against official 2026 tax brackets and social contribution rates, and every response includes the date the rules were last reviewed. Results are estimates for standard employment income and do not replace professional tax advice.

Does it calculate employer cost as well as net pay?

Yes. Every calculation returns both the employee net take-home pay and the total cost to employ — gross salary plus employer social contributions — which is what finance teams need for budgeting and quoting international hires.

Is there a free tier?

Yes — 100 calls per month with all 18 countries included. Paid tiers start at €49 per month for 10,000 calls and add country comparison and the bank holidays API.

How do I get started?

Create a free API key in the dashboard, then send your first request with a single curl command. No SDK, contract or sales call required.

A salary calculation API built for payroll, EOR and finance teams