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.

TööriistadAPI

NetSalary APIv1

Netopalk ja tööandja kogukulu 18 riigis — üks REST-päring

Hangi tasuta API võti

API olekKontrollime

Kontrollime

Kontroll mõõdab kogu edasi-tagasi teekonda koos võrguajaga; serveri näitajad on ainult töötlusaeg ega sisalda võrku.

Hinnad

Alusta tasuta, uuenda kui maht kasvab.

2 kuud tasuta

Tasuta

0 € igavesti

100 päringut / kuu

Kõik otspunktid, midagi pole lukus
Kõik 18 riiki
Netopalk + tööandja kulu
Piisab, et enne ostu järele proovida

Hangi võti

Solo

29 € /kuu

2500 päringut / kuu

Kõik Tasuta plaanist
25× tasuta plaani päringumaht
0.0116 € päringu kohta
E-posti tugi

Populaarseim

Starter

99 € /kuu

10 000 päringut / kuu

Kõik Solo plaanist
100× tasuta plaani päringumaht
0.0099 € päringu kohta

Scale

299 € /kuu

100 000 päringut / kuu

Kõik Starter plaanist
1000× tasuta plaani päringumaht
0.0030 € päringu kohta
Mahupõhised hinnad saadaval
Eelisjärjekorras tugi

Hinnad ei sisalda käibemaksu. Tühista igal ajal arveldusportaalis.

Vajad üle 100 000 päringu, white-label vidinat või SLA-d? Võta ühendust.

Võta ühendust

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.

Integreeri minutitega

Üks päring sisse, täielik palgajaotus välja. SDK-d pole vaja.

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

Otspunktid

Üheksa otspunkti: arvutused, maksuandmed ja turukontekst.

POST/api/v1/calculate

Netopalk, tööandja kulu ja üksikasjalik jaotus ühe riigi kohta

POST/api/v1/compare

Sama arvutus mitme riigi jaoks korraga

POST/api/v1/reverse

Soovitud netopalk sisse, vajalik brutopalk välja — täieliku jaotusega

GET/api/v1/countries

Toetatud riigid ja andmete värskus

GET/api/v1/brackets/:country

Maksuastmed ja sotsiaalmaksed

GET/api/v1/rates

Reaalajas EUR vahetuskursid kõigile toetatud valuutadele

GET/api/v1/holidays/:country

Riigipühad riigi ja aasta kaupa

GET/api/v1/percentiles/:country

Kus palk asub riigi jaotuses (p10–p99)

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

Üüri-, toidu- ja ostujõuindeksid riigiti

Iga otspunkt vastab tasuta võtmele — 100 päringut kuus. Tasulised plaanid lisavad mahtu, mitte otspunkte.

Dokumentatsioon

Kõik integreerimiseks vajalik: autentimine, parameetrid ja veakäsitlus.

Autentimine

Saada oma API võti Bearer-tokenina Authorization päises. Loo ja halda võtmeid töölaualt. /developers/keys

Authorization: Bearer nsk_live_…

Päringu parameetrid

Keha väljad POST /api/v1/calculate ja /api/v1/compare jaoks.

countrystringkohustuslik

Kahetäheline riigikood, nt "de"

countriesstring[]valikuline

Riigikoodide massiiv (ainult /compare, asendab country)

grossnumberkohustuslik

Brutopalk riigi kohalikus valuutas

periodstringkohustuslik

Brutosumma periood: "monthly" või "yearly"

yearnumbervalikuline

Maksuaasta: 2025, 2026 või 2027 (vaikimisi 2026). 2027 on alles osaliselt vastu võetud — vt vastuses yearDataStatus.

Vastuse väljad

netnumber

Netopalk perioodi kohta

employerCostnumber

Töölevõtmise kogukulu: bruto + tööandja maksed

effectiveRatenumber

Efektiivne maksumäär protsentides

currencystring

Kõigi summade kohalik valuuta

breakdownarray

Üksikasjalikud maksuread: tulumaks, sotsiaalmaksed ja muu

Pöördarvutus

POST/api/v1/reverse

Saada kandidaadi soovitud netopalk; saad vastu vajaliku brutopalga ja tööandja kulu.

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

Riigipühad

GET /api/v1/holidays/:country

Riigipühad lokaliseeritud nimedega. Parameetrid: year (2026 või 2027) ja lang (11 keelt).

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

Vead

401

API võti puudub või on vigane

422

Valideerimine ebaõnnestus: toetamata riik, vale summa või aasta

429

Kuu kvoot ületatud

Palgaarvutuse API palga-, EOR- ja finantstiimidele

NetSalary API muudab brutopalgad netopalgaks ja tööandja kogukuluks 18 riigi 2026. aasta maksureeglite alusel — 16 Euroopas ning lisaks Brasiilia ja AÜE — tulumaksuastmed, sotsiaalmaksed ja tööandja kulud kaasas. See on sama mootor, mis töötab NetSalary kalkulaatori taga, saadaval lihtsa REST API-na palgatarkvarale, EOR-platvormidele, kolimistööriistadele ja HR-süsteemidele.

Mida tiimid sellega ehitavad

Palk ja raamatupidamine

Näita töötajatele täpset netopalka ja finantstiimile iga töötaja tegelikku kulu enne palgaarvestust.

EOR ja globaalne värbamine

Arvuta 18 riigi kogutööjõukulu ühe päringuga rahvusvaheliste pakkumiste hindamisel.

Kolimine ja mobiilsus

Võrdle netopalka riikide vahel, et kandidaadid näeksid pakkumise tegelikku väärtust pärast makse.

Tööportaalid ja fintech

Rikasta kuulutusi ja finantstooteid netopalga hinnangute ning riigipühade kalendritega.

Korduma kippuvad küsimused

Mis on netopalga API?

REST-teenus, mis teisendab brutopalga netopalgaks. Saadad riigi, brutosumma ja perioodi; API tagastab netopalga, tööandja kogukulu, efektiivse maksumäära ning tulumaksu ja sotsiaalmaksete üksikasjaliku jaotuse.

Milliseid riike API toetab?

Kaheksateist riiki: Saksamaa, Ühendkuningriik, Holland, Hispaania, Poola, Šveits, Iirimaa, Portugal, Rootsi, Norra, Soome, Eesti, Läti, Leedu, Austria, Belgia, Brasiilia ja AÜE — 2025. ja 2026. aasta maksureeglitega.

Kui täpsed on arvutused?

Iga riigi reegleid hoitakse vastavuses ametlike 2026. aasta maksuastmete ja sotsiaalmaksetega ning iga vastus sisaldab reeglite viimase ülevaatuse kuupäeva. Tulemused on hinnangud tavalisele palgatulule ega asenda professionaalset maksunõustamist.

Kas see arvutab ka tööandja kulu?

Jah. Iga arvutus tagastab nii töötaja netopalga kui ka töölevõtmise kogukulu — bruto pluss tööandja sotsiaalmaksed — täpselt selle, mida finantstiimid eelarvestamiseks ja rahvusvaheliste palkade hindamiseks vajavad.

Kas tasuta plaan on olemas?

Jah — 100 päringut kuus, kõigi otspunktide ja kõigi 18 riigiga, nii et kogu liidestuse saab valmis ehitada enne maksmist. Tasulised plaanid erinevad ainult mahu poolest: 29 €/kuu 2500 päringu eest, 99 € 10 000 eest ja 299 € 100 000 eest.

Kuidas alustada?

Loo töölaual tasuta API võti ja saada esimene päring ühe curl-käsuga. Ilma SDK, lepingu või müügikõneta.

Palgaarvutuse API palga-, EOR- ja finantstiimidele