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.

VerktøyAPI

NetSalary APIv1

Nettolønn og total arbeidsgiverkostnad for 18 land — ett REST-kall

Få din gratis API-nøkkel

API-statusSjekker

Sjekker

Testen måler hele veien tur-retur inkludert nettverkstid; servertallene er ren behandlingstid og tar ikke med nettverket.

Priser

Start gratis, oppgrader når volumet vokser.

2 måneder gratis

Gratis

0 € for alltid

100 kall / måned

Alle endepunkter, ingenting låst
Alle 18 land
Netto + arbeidsgiverkostnad
Nok til å teste før du kjøper

Få nøkkel

Solo

29 € /måned

2 500 kall / måned

Alt i Gratis
25× kallvolumet på gratisnivået
0.0116 € per kall
E-poststøtte

Mest populær

Starter

99 € /måned

10 000 kall / måned

Alt i Solo
100× kallvolumet på gratisnivået
0.0099 € per kall

Scale

299 € /måned

100 000 kall / måned

Alt i Starter
1 000× kallvolumet på gratisnivået
0.0030 € per kall
Volumpriser tilgjengelig
Prioritert støtte

Priser eks. mva. Avslutt når som helst i faktureringsportalen.

Trenger du mer enn 100 000 kall, en white label-widget eller en SLA? Ta kontakt.

Kontakt 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.

Integrer på minutter

Én forespørsel inn, full lønnsoppdeling ut. Ingen SDK nødvendig.

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"}'

Endepunkter

Ni endepunkter: beregninger, skattedata og markedskontekst.

POST/api/v1/calculate

Nettolønn, arbeidsgiverkostnad og detaljert oppdeling for ett land

POST/api/v1/compare

Samme beregning for flere land samtidig

POST/api/v1/reverse

Ønsket netto inn, nødvendig brutto ut — med full oppdeling

GET/api/v1/countries

Støttede land og dataenes aktualitet

GET/api/v1/brackets/:country

Skattetrinn og sosiale avgifter

GET/api/v1/rates

Sanntids EUR-valutakurser for alle støttede valutaer

GET/api/v1/holidays/:country

Offentlige helligdager per land og år

GET/api/v1/percentiles/:country

Hvor en lønn ligger i landets fordeling (p10–p99)

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

Leie-, mat- og kjøpekraftindekser per land

Hvert endepunkt svarer på en gratis nøkkel — 100 kall per måned. Betalte nivåer gir mer volum, ikke flere endepunkter.

Dokumentasjon

Alt du trenger for integrasjonen: autentisering, parametere og feilhåndtering.

Autentisering

Send API-nøkkelen din som Bearer-token i Authorization-headeren. Opprett og administrer nøkler i panelet. /developers/keys

Authorization: Bearer nsk_live_…

Forespørselsparametere

Body-felt for POST /api/v1/calculate og /api/v1/compare.

countrystringpåkrevd

Landkode med to bokstaver, f.eks. "de"

countriesstring[]valgfri

Array med landkoder (kun /compare, erstatter country)

grossnumberpåkrevd

Bruttolønn i landets lokale valuta

periodstringpåkrevd

Bruttobeløpets periode: "monthly" eller "yearly"

yearnumbervalgfri

Skatteår: 2025, 2026 eller 2027 (standard 2026). 2027 er bare delvis vedtatt — se yearDataStatus i svaret.

Svarfelt

netnumber

Nettolønn per periode

employerCostnumber

Total ansettelseskostnad: brutto + arbeidsgiveravgifter

effectiveRatenumber

Effektiv skattesats i prosent

currencystring

Lokal valuta for alle beløp

breakdownarray

Spesifiserte skattelinjer: inntektsskatt, sosiale avgifter og mer

Omvendt beregning

POST/api/v1/reverse

Send nettolønnen kandidaten ønsker; få bruttoen du må tilby og arbeidsgiverkostnaden.

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

Helligdager

GET /api/v1/holidays/:country

Offentlige helligdager med lokaliserte navn. Parametere: year (2026 eller 2027) og lang (11 språk).

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

Feil

401

Manglende eller ugyldig API-nøkkel

422

Validering mislyktes: land ikke støttet, ugyldig beløp eller år

429

Månedskvote overskredet

Et lønnsberegnings-API for lønns-, EOR- og økonomiteam

NetSalary API gjør bruttolønn om til nettolønn og total arbeidsgiverkostnad etter 2026-skattereglene i 18 land — 16 i Europa pluss Brasil og De forente arabiske emirater — skattetrinn, sosiale avgifter og arbeidsgiveravgifter inkludert. Det er samme motor som driver NetSalary-kalkulatoren, tilgjengelig som et enkelt REST-API for lønnssystemer, EOR-plattformer, relokasjonsverktøy og HR-systemer.

Hva team bygger med det

Lønn & regnskap

Vis ansatte nøyaktig nettolønn og økonomiteamet den reelle kostnaden for hver ansettelse før lønnskjøringen.

EOR & global rekruttering

Beregn total ansettelseskostnad i 18 land med én forespørsel når du priser internasjonale tilbud.

Relokasjon & mobilitet

Sammenlign nettolønn mellom land slik at kandidater ser hva et tilbud faktisk er verdt etter skatt.

Jobbportaler & fintech

Berik annonser og finansprodukter med nettolønnsestimater og helligdagskalendere.

Ofte stilte spørsmål

Hva er et nettolønns-API?

En REST-tjeneste som konverterer bruttolønn til nettolønn. Du sender land, bruttobeløp og periode; API-et returnerer nettolønn, total arbeidsgiverkostnad, effektiv skattesats og en spesifisert oppdeling av inntektsskatt og sosiale avgifter.

Hvilke land støtter lønns-API-et?

Atten land: Tyskland, Storbritannia, Nederland, Spania, Polen, Sveits, Irland, Portugal, Sverige, Norge, Finland, Estland, Latvia, Litauen, Østerrike, Belgia, Brasil og De forente arabiske emirater — med skatteregler for 2025 og 2026.

Hvor nøyaktige er beregningene?

Hvert lands regler vedlikeholdes mot offisielle skattetrinn og sosiale avgifter for 2026, og hvert svar inkluderer datoen reglene sist ble gjennomgått. Resultatene er estimater for vanlig lønnsinntekt og erstatter ikke profesjonell skatterådgivning.

Beregner det også arbeidsgiverkostnaden?

Ja. Hver beregning returnerer både den ansattes nettolønn og den totale ansettelseskostnaden — brutto pluss arbeidsgiveravgifter — akkurat det økonomiteam trenger for budsjettering og prising av internasjonale ansettelser.

Finnes det et gratisnivå?

Ja — 100 kall per måned, med alle endepunkter og alle 18 land, så du rekker å bygge hele integrasjonen før du betaler. De betalte nivåene skiller seg bare på volum: 29 €/måned for 2 500 kall, 99 € for 10 000 og 299 € for 100 000.

Hvordan kommer jeg i gang?

Opprett en gratis API-nøkkel i panelet og send din første forespørsel med én curl-kommando. Ingen SDK, kontrakt eller salgssamtale.

Et lønnsberegnings-API for lønns-, EOR- og økonomiteam