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 plans start at €29 per month for 2,500 calls and add the country comparison and reverse net-to-gross endpoints; bank holidays, salary percentiles and cost of living come with Starter at €99 per month.

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.

VerktygAPI

NetSalary APIv1

Nettolön och total arbetsgivarkostnad för 18 länder — ett REST-anrop

Skaffa din gratis API-nyckel

API-statusKontrollerar

Kontrollerar

Testet mäter hela vägen fram och tillbaka inklusive nätverkstid; serversiffrorna är enbart bearbetningstid och räknar inte med nätverket.

Priser

Börja gratis, uppgradera när volymen växer.

2 månader gratis

Gratis

0 € för alltid

100 anrop / månad

Alla endpoints, inget låst
Alla 18 länder
Netto + arbetsgivarkostnad
Räcker för att utvärdera före köp

Skaffa nyckel

Solo

29 € /månad

2 500 anrop / månad

Allt i Gratis
25× gratisnivåns anropsvolym
0.0116 € per anrop
E-postsupport

Mest populär

Starter

99 € /månad

10 000 anrop / månad

Allt i Solo
100× gratisnivåns anropsvolym
0.0099 € per anrop

Scale

299 € /månad

100 000 anrop / månad

Allt i Starter
1 000× gratisnivåns anropsvolym
0.0030 € per anrop
Volympriser tillgängliga
Prioriterad support

Priser exkl. moms. Avsluta när du vill i faktureringsportalen.

Behöver du fler än 100 000 anrop, en white label-widget eller ett SLA? Hör av dig.

Kontakta oss

How the tax data is verified — and where it is notPer country: how strongly each published bracket table is asserted against the engine, the reason the rest cannot be, the official source behind it, when the rules were last reviewed, and the limitations we know about. Generated from the verification guards on every build, so it cannot go stale.

Integrera på minuter

En förfrågan in, en komplett löneuppdelning ut. Ingen SDK behövs.

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

Nio endpoints: beräkningar, skattedata och marknadskontext.

POST/api/v1/calculate

Nettolön, arbetsgivarkostnad och detaljerad uppdelning för ett land

POST/api/v1/compare

Samma beräkning för flera länder samtidigt

POST/api/v1/reverse

Önskad nettolön in, nödvändig bruttolön ut — med full uppdelning

GET/api/v1/countries

Länder som stöds och datans aktualitet

GET/api/v1/brackets/:country

Skatteskikt och sociala avgifter

GET/api/v1/rates

EUR-växelkurser i realtid för alla valutor som stöds

GET/api/v1/holidays/:country

Allmänna helgdagar per land och år

GET/api/v1/percentiles/:country

Var en lön ligger i landets fördelning (p10–p99)

GET/api/v1/cost-of-living/:country

Hyres-, mat- och köpkraftsindex per land

Varje endpoint svarar på en gratisnyckel — 100 anrop per månad. Betalda nivåer ger mer volym, inte fler endpoints.

Dokumentation

Allt du behöver för integrationen: autentisering, parametrar och felhantering.

Autentisering

Skicka din API-nyckel som Bearer-token i Authorization-headern. Skapa och hantera nycklar i panelen. /developers/keys

Authorization: Bearer nsk_live_…

Förfrågans parametrar

Body-fält för POST /api/v1/calculate och /api/v1/compare.

countrystringobligatorisk

Landskod med två bokstäver, t.ex. "de"

countriesstring[]valfri

Array med landskoder (endast /compare, ersätter country)

grossnumberobligatorisk

Bruttolön i landets lokala valuta

periodstringobligatorisk

Bruttobeloppets period: "monthly" eller "yearly"

yearnumbervalfri

Skatteår: 2025, 2026 eller 2027 (standard 2026). 2027 är bara delvis beslutat — se yearDataStatus i svaret.

Svarsfält

netnumber

Nettolön per period

employerCostnumber

Total anställningskostnad: brutto + arbetsgivaravgifter

effectiveRatenumber

Effektiv skattesats i procent

currencystring

Lokal valuta för alla belopp

breakdownarray

Specificerade skatterader: inkomstskatt, sociala avgifter med mera

Omvänd beräkning

POST/api/v1/reverse

Skicka nettolönen kandidaten vill ha; få bruttot du behöver erbjuda och arbetsgivarkostnaden.

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

Helgdagar

GET /api/v1/holidays/:country

Allmänna helgdagar med lokaliserade namn. Parametrar: year (2026 eller 2027) och lang (11 språk).

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

Fel

401

Saknad eller ogiltig API-nyckel

422

Validering misslyckades: land stöds inte, felaktigt belopp eller år

429

Månadskvot överskriden

Ett löneberäknings-API för löne-, EOR- och ekonomiteam

NetSalary API omvandlar bruttolöner till nettolön och total arbetsgivarkostnad enligt 2026 års skatteregler i 18 länder — 16 i Europa samt Brasilien och Förenade Arabemiraten — skatteskikt, sociala avgifter och arbetsgivaravgifter inkluderade. Det är samma motor som driver NetSalary-kalkylatorn, exponerad som ett enkelt REST-API för lönesystem, EOR-plattformar, relocationverktyg och HR-system.

Vad team bygger med det

Lön & redovisning

Visa anställda exakt nettolön och ekonomiteamet den verkliga kostnaden för varje anställning före lönekörningen.

EOR & global rekrytering

Beräkna total anställningskostnad i 18 länder med en enda förfrågan när du prissätter internationella erbjudanden.

Relocation & mobilitet

Jämför nettolön mellan länder så att kandidater ser vad ett erbjudande verkligen är värt efter skatt.

Jobbsajter & fintech

Berika annonser och finansiella produkter med nettolöneuppskattningar och helgdagskalendrar.

Vanliga frågor

Vad är ett nettolöne-API?

En REST-tjänst som omvandlar bruttolön till nettolön. Du skickar land, bruttobelopp och period; API:et returnerar nettolön, total arbetsgivarkostnad, effektiv skattesats och en specificerad uppdelning av inkomstskatt och sociala avgifter.

Vilka länder stöder löne-API:et?

Arton länder: Tyskland, Storbritannien, Nederländerna, Spanien, Polen, Schweiz, Irland, Portugal, Sverige, Norge, Finland, Estland, Lettland, Litauen, Österrike, Belgien, Brasilien och Förenade Arabemiraten — med skatteregler för 2025 och 2026.

Hur exakta är beräkningarna?

Varje lands regler underhålls mot officiella skatteskikt och sociala avgifter för 2026, och varje svar innehåller datumet då reglerna senast granskades. Resultaten är uppskattningar för vanlig löneinkomst och ersätter inte professionell skatterådgivning.

Beräknar det även arbetsgivarkostnaden?

Ja. Varje beräkning returnerar både den anställdas nettolön och den totala anställningskostnaden — brutto plus arbetsgivaravgifter — precis det ekonomiteam behöver för budgetering och prissättning av internationella anställningar.

Finns det en gratisnivå?

Ja — 100 anrop per månad, med alla endpoints och alla 18 länder, så du hinner bygga hela integrationen innan du betalar. De betalda nivåerna skiljer sig bara i volym: 29 €/månad för 2 500 anrop, 99 € för 10 000 och 299 € för 100 000.

Hur kommer jag igång?

Skapa en gratis API-nyckel i panelen och skicka din första förfrågan med ett enda curl-kommando. Ingen SDK, inget avtal, inget säljsamtal.

Ett löneberäknings-API för löne-, EOR- och ekonomiteam