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.

TyökalutAPI

NetSalary APIv1

Nettopalkka ja työnantajan kokonaiskulut 18 maassa — yksi REST-kutsu

Hanki ilmainen API-avain

API:n tilaTarkistetaan

Tarkistetaan

Testi mittaa koko edestakaisen matkan verkkoviiveineen; palvelinluvut ovat pelkkää käsittelyaikaa eivätkä sisällä verkkoa.

Hinnoittelu

Aloita ilmaiseksi, päivitä kun volyymi kasvaa.

2 kuukautta ilmaiseksi

Ilmainen

0 € ikuisesti

100 kutsua / kk

Kaikki päätepisteet, ei lukkoja
Kaikki 18 maata
Netto + työnantajakulut
Riittää arviointiin ennen ostoa

Hanki avain

Solo

29 € /kk

2 500 kutsua / kk

Kaikki Ilmainen-tasosta
25× ilmaistason kutsumäärä
0.0116 € / kutsu
Sähköpostituki

Suosituin

Starter

99 € /kk

10 000 kutsua / kk

Kaikki Solo-tasosta
100× ilmaistason kutsumäärä
0.0099 € / kutsu

Scale

299 € /kk

100 000 kutsua / kk

Kaikki Starter-tasosta
1 000× ilmaistason kutsumäärä
0.0030 € / kutsu
Volyymihinnoittelu saatavilla
Priorisoitu tuki

Hinnat ilman alv:tä. Peru milloin tahansa laskutusportaalista.

Tarvitsetko yli 100 000 kutsua, white label -widgetin tai SLA:n? Ota yhteyttä.

Ota yhteyttä

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.

Integroi minuuteissa

Yksi pyyntö sisään, täysi palkkaerittely ulos. SDK:ta ei tarvita.

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

Päätepisteet

Yhdeksän päätepistettä: laskelmat, verotiedot ja markkinakonteksti.

POST/api/v1/calculate

Nettopalkka, työnantajakulut ja eritelty laskelma yhdelle maalle

POST/api/v1/compare

Sama laskelma useille maille kerralla

POST/api/v1/reverse

Toivottu netto sisään, tarvittava brutto ulos — täydellä erittelyllä

GET/api/v1/countries

Tuetut maat ja datan tuoreus

GET/api/v1/brackets/:country

Veroasteikot ja sosiaalimaksut

GET/api/v1/rates

Reaaliaikaiset EUR-valuuttakurssit kaikille tuetuille valuutoille

GET/api/v1/holidays/:country

Yleiset vapaapäivät maittain ja vuosittain

GET/api/v1/percentiles/:country

Mihin palkka sijoittuu maan jakaumassa (p10–p99)

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

Vuokra-, ruoka- ja ostovoimaindeksit maittain

Jokainen päätepiste vastaa ilmaisella avaimella — 100 kutsua kuukaudessa. Maksulliset tasot tuovat lisää volyymia, eivät päätepisteitä.

Dokumentaatio

Kaikki integrointiin tarvittava: autentikointi, parametrit ja virheenkäsittely.

Autentikointi

Lähetä API-avaimesi Bearer-tokenina Authorization-otsakkeessa. Luo ja hallitse avaimia hallintapaneelissa. /developers/keys

Authorization: Bearer nsk_live_…

Pyynnön parametrit

Body-kentät POST /api/v1/calculate ja /api/v1/compare -kutsuille.

countrystringpakollinen

Kaksikirjaiminen maakoodi, esim. "de"

countriesstring[]valinnainen

Maakoodien taulukko (vain /compare, korvaa country-kentän)

grossnumberpakollinen

Bruttopalkka maan paikallisessa valuutassa

periodstringpakollinen

Bruttosumman jakso: "monthly" tai "yearly"

yearnumbervalinnainen

Verovuosi: 2025, 2026 tai 2027 (oletus 2026). Vuosi 2027 on vasta osittain säädetty — katso vastauksen yearDataStatus.

Vastauksen kentät

netnumber

Nettopalkka jaksoa kohden

employerCostnumber

Työllistämisen kokonaiskulu: brutto + työnantajamaksut

effectiveRatenumber

Efektiivinen veroaste prosentteina

currencystring

Kaikkien summien paikallinen valuutta

breakdownarray

Eritellyt verorivit: tulovero, sosiaalimaksut ja muut

Käänteinen laskenta

POST/api/v1/reverse

Lähetä ehdokkaan toivoma nettopalkka; saat tarvittavan bruton ja työnantajakustannuksen.

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

Arkipyhät

GET /api/v1/holidays/:country

Yleiset vapaapäivät lokalisoiduilla nimillä. Parametrit: year (2026 tai 2027) ja lang (11 kieltä).

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

Virheet

401

API-avain puuttuu tai on virheellinen

422

Validointi epäonnistui: maa ei tuettu, virheellinen summa tai vuosi

429

Kuukausikiintiö ylitetty

Palkanlaskenta-API palkka-, EOR- ja taloustiimeille

NetSalary API muuntaa bruttopalkat nettopalkaksi ja työnantajan kokonaiskuluiksi 18 maan vuoden 2026 verosäännöillä — 16 Euroopassa sekä Brasilia ja Arabiemiirikunnat — tuloveroasteikot, sosiaalimaksut ja työnantajamaksut mukaan lukien. Se on sama moottori kuin NetSalary-laskurissa, tarjolla yksinkertaisena REST-API:na palkkaohjelmistoille, EOR-alustoille, muuttopalveluille ja HR-järjestelmille.

Mitä tiimit rakentavat sillä

Palkanlaskenta ja kirjanpito

Näytä työntekijöille tarkka nettopalkka ja taloustiimille jokaisen rekrytoinnin todelliset kustannukset ennen palkka-ajoa.

EOR ja globaali rekrytointi

Laske työllistämisen kokonaiskustannus 18 maassa yhdellä pyynnöllä kansainvälisiä tarjouksia hinnoitellessasi.

Muutto ja liikkuvuus

Vertaa nettopalkkaa maiden välillä, jotta ehdokkaat näkevät tarjouksen todellisen arvon verojen jälkeen.

Työpaikkasivustot ja fintech

Rikasta ilmoituksia ja finanssituotteita nettopalkka-arvioilla ja pyhäpäiväkalentereilla.

Usein kysytyt kysymykset

Mikä on nettopalkka-API?

REST-palvelu, joka muuntaa bruttopalkan nettopalkaksi. Lähetät maan, bruttosumman ja jakson; API palauttaa nettopalkan, työnantajan kokonaiskulut, efektiivisen veroasteen sekä eritellyn laskelman tuloverosta ja sosiaalimaksuista.

Mitä maita API tukee?

Kahdeksantoista maata: Saksa, Iso-Britannia, Alankomaat, Espanja, Puola, Sveitsi, Irlanti, Portugali, Ruotsi, Norja, Suomi, Viro, Latvia, Liettua, Itävalta, Belgia, Brasilia ja Arabiemiirikunnat — vuosien 2025 ja 2026 verosäännöillä.

Kuinka tarkkoja laskelmat ovat?

Kunkin maan säännöt ylläpidetään virallisten vuoden 2026 veroasteikkojen ja sosiaalimaksujen mukaan, ja jokainen vastaus sisältää sääntöjen viimeisimmän tarkistuspäivän. Tulokset ovat arvioita tavanomaiselle palkkatulolle eivätkä korvaa ammattimaista veroneuvontaa.

Laskeeko se myös työnantajakulut?

Kyllä. Jokainen laskelma palauttaa sekä työntekijän nettopalkan että työllistämisen kokonaiskulut — brutto plus työnantajan sosiaalimaksut — juuri sen, mitä taloustiimit tarvitsevat budjetointiin ja kansainvälisten rekrytointien hinnoitteluun.

Onko ilmaista tasoa?

Kyllä — 100 kutsua kuukaudessa, kaikilla päätepisteillä ja kaikilla 18 maalla, joten koko integraation ehtii rakentaa ennen maksamista. Maksulliset tasot eroavat vain volyymiltaan: 29 €/kk 2 500 kutsusta, 99 € 10 000:sta ja 299 € 100 000:sta.

Miten pääsen alkuun?

Luo ilmainen API-avain hallintapaneelissa ja lähetä ensimmäinen pyyntö yhdellä curl-komennolla. Ei SDK:ta, sopimusta tai myyntipuhelua.

Palkanlaskenta-API palkka-, EOR- ja taloustiimeille