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.

NarzędziaAPI

NetSalary APIv1

Pensja netto i całkowity koszt pracodawcy w 18 krajach — jedno wywołanie REST

Odbierz darmowy klucz API

Status APISprawdzanie

Sprawdzanie

Test mierzy pełną drogę w obie strony wraz z czasem sieci; liczby serwerowe to sam czas przetwarzania, bez sieci.

Cennik

Zacznij za darmo, przejdź wyżej gdy urośnie wolumen.

2 miesiące gratis

Darmowy

0 € na zawsze

100 wywołań / mies.

Wszystkie endpointy, nic nie jest zablokowane
Wszystkie 18 krajów
Netto + koszt pracodawcy
Wystarczy, by przetestować przed zakupem

Pobierz klucz

Solo

29 € /mies.

2500 wywołań / mies.

Wszystko z planu Darmowy
25× limit wywołań z planu darmowego
0.0116 € za wywołanie
Wsparcie e-mail

Najpopularniejszy

Starter

99 € /mies.

10 000 wywołań / mies.

Wszystko z planu Solo
100× limit wywołań z planu darmowego
0.0099 € za wywołanie

Scale

299 € /mies.

100 000 wywołań / mies.

Wszystko z planu Starter
1000× limit wywołań z planu darmowego
0.0030 € za wywołanie
Dostępne rabaty ilościowe
Priorytetowe wsparcie

Ceny bez VAT. Anuluj w dowolnym momencie w portalu płatności.

Potrzebujesz ponad 100 000 wywołań, widżetu white-label lub SLA? Napisz do nas.

Skontaktuj się

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.

Integracja w kilka minut

Jedno zapytanie, pełne rozbicie wynagrodzenia w odpowiedzi. Bez SDK.

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

Endpointy

Dziewięć endpointów: obliczenia, dane podatkowe i kontekst rynkowy.

POST/api/v1/calculate

Netto, koszt pracodawcy i szczegółowe rozbicie dla jednego kraju

POST/api/v1/compare

To samo obliczenie dla wielu krajów naraz

POST/api/v1/reverse

Docelowe netto na wejściu, wymagane brutto na wyjściu — z pełnym rozbiciem

GET/api/v1/countries

Obsługiwane kraje i aktualność danych

GET/api/v1/brackets/:country

Progi podatkowe i składki społeczne

GET/api/v1/rates

Bieżące kursy wymiany EUR dla wszystkich obsługiwanych walut

GET/api/v1/holidays/:country

Dni ustawowo wolne wg kraju i roku

GET/api/v1/percentiles/:country

Gdzie pensja plasuje się w rozkładzie kraju (p10–p99)

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

Indeksy najmu, zakupów i siły nabywczej wg kraju

Każdy endpoint odpowiada na darmowy klucz — 100 wywołań miesięcznie. Płatne plany dodają limit, a nie endpointy.

Dokumentacja

Wszystko czego potrzebujesz do integracji: uwierzytelnianie, parametry i obsługa błędów.

Uwierzytelnianie

Wyślij klucz API jako token Bearer w nagłówku Authorization. Klucze tworzysz i zarządzasz nimi w panelu. /developers/keys

Authorization: Bearer nsk_live_…

Parametry zapytania

Pola body dla POST /api/v1/calculate i /api/v1/compare.

countrystringwymagany

Dwuliterowy kod kraju, np. "de"

countriesstring[]opcjonalny

Tablica kodów krajów (tylko /compare, zastępuje country)

grossnumberwymagany

Pensja brutto w lokalnej walucie kraju

periodstringwymagany

Okres kwoty brutto: "monthly" lub "yearly"

yearnumberopcjonalny

Rok podatkowy: 2025, 2026 lub 2027 (domyślnie 2026). Rok 2027 jest uchwalony tylko częściowo — zob. yearDataStatus w odpowiedzi.

Pola odpowiedzi

netnumber

Pensja netto za okres

employerCostnumber

Całkowity koszt zatrudnienia: brutto + składki pracodawcy

effectiveRatenumber

Efektywna stawka podatkowa w procentach

currencystring

Lokalna waluta wszystkich kwot

breakdownarray

Szczegółowe pozycje podatkowe: podatek dochodowy, składki społeczne i inne

Odwrotne obliczenie

POST/api/v1/reverse

Wyślij netto, jakiego oczekuje kandydat; otrzymasz wymagane brutto i koszt pracodawcy.

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

Dni wolne

GET /api/v1/holidays/:country

Dni ustawowo wolne z lokalizowanymi nazwami. Parametry: year (2026 lub 2027) i lang (11 języków).

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

Błędy

401

Brak lub nieprawidłowy klucz API

422

Walidacja nie powiodła się: nieobsługiwany kraj, zła kwota lub rok

429

Przekroczono miesięczny limit

API obliczania wynagrodzeń dla zespołów payroll, EOR i finansów

NetSalary API zamienia pensje brutto w wynagrodzenie netto i całkowity koszt pracodawcy według reguł podatkowych 2026 dla 18 krajów — 16 w Europie oraz Brazylii i ZEA — progi podatkowe, składki społeczne i obciążenia pracodawcy w komplecie. To ten sam silnik, który napędza kalkulator NetSalary, udostępniony jako proste REST API dla oprogramowania płacowego, platform EOR, narzędzi relokacyjnych i systemów HR.

Co zespoły z tym budują

Płace i księgowość

Pokazuj pracownikom dokładne netto, a zespołowi finansów prawdziwy koszt każdego zatrudnienia przed naliczeniem płac.

EOR i globalna rekrutacja

Wyceń całkowity koszt zatrudnienia w 18 krajach jednym zapytaniem przy kalkulacji ofert międzynarodowych.

Relokacja i mobilność

Porównuj wynagrodzenie netto między krajami, aby kandydaci widzieli realną wartość oferty po opodatkowaniu.

Portale pracy i fintech

Wzbogacaj ogłoszenia i produkty finansowe o szacunki netto i kalendarze dni wolnych.

Najczęstsze pytania

Czym jest API wynagrodzenia netto?

To usługa REST zamieniająca pensję brutto na netto. Wysyłasz kraj, kwotę brutto i okres; API zwraca netto, całkowity koszt pracodawcy, efektywną stawkę podatkową oraz szczegółowe rozbicie podatku dochodowego i składek społecznych.

Które kraje obsługuje API?

Osiemnaście krajów: Niemcy, Wielka Brytania, Holandia, Hiszpania, Polska, Szwajcaria, Irlandia, Portugalia, Szwecja, Norwegia, Finlandia, Estonia, Łotwa, Litwa, Austria, Belgia, Brazylia i ZEA — z regułami podatkowymi na 2025 i 2026 rok.

Jak dokładne są obliczenia?

Reguły każdego kraju są utrzymywane zgodnie z oficjalnymi progami podatkowymi i składkami na 2026 rok, a każda odpowiedź zawiera datę ostatniego przeglądu reguł. Wyniki to szacunki dla standardowego dochodu z pracy i nie zastępują profesjonalnego doradztwa podatkowego.

Czy liczy też koszt pracodawcy oprócz netto?

Tak. Każde obliczenie zwraca zarówno netto pracownika, jak i całkowity koszt zatrudnienia — brutto plus składki pracodawcy — dokładnie to, czego zespoły finansowe potrzebują do budżetowania i wyceny zatrudnień międzynarodowych.

Czy jest darmowy plan?

Tak — 100 wywołań miesięcznie, ze wszystkimi endpointami i wszystkimi 18 krajami, więc całą integrację można zbudować przed zapłatą. Płatne plany różnią się wyłącznie limitem: 29 € miesięcznie za 2500 wywołań, 99 € za 10 000 i 299 € za 100 000.

Jak zacząć?

Utwórz darmowy klucz API w panelu i wyślij pierwsze zapytanie jednym poleceniem curl. Bez SDK, umowy i rozmowy handlowej.

API obliczania wynagrodzeń dla zespołów payroll, EOR i finansów