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.

WerkzeugeAPI

NetSalary APIv1

Nettogehalt & Arbeitgeber-Gesamtkosten für 18 Länder — ein REST-Aufruf

Kostenlosen API-Schlüssel holen

API-StatusWird geprüft

Wird geprüft

Der Test misst den vollen Roundtrip inklusive Netzwerkzeit; die Serverwerte sind reine Verarbeitungszeit und enthalten kein Netzwerk.

Preise

Kostenlos starten, bei mehr Volumen upgraden.

2 Monate gratis

Kostenlos

0 € für immer

100 Aufrufe / Monat

Alle Endpunkte, nichts gesperrt
Alle 18 Länder
Netto + Arbeitgeberkosten
Genug, um vor dem Kauf zu testen

Schlüssel holen

Solo

29 € /Monat

2.500 Aufrufe / Monat

Alles aus dem Gratis-Tarif
25× so viele Aufrufe wie im Gratistarif
0.0116 € pro Aufruf
E-Mail-Support

Am beliebtesten

Starter

99 € /Monat

10.000 Aufrufe / Monat

Alles aus dem Solo-Tarif
100× so viele Aufrufe wie im Gratistarif
0.0099 € pro Aufruf

Scale

299 € /Monat

100.000 Aufrufe / Monat

Alles aus dem Starter-Tarif
1.000× so viele Aufrufe wie im Gratistarif
0.0030 € pro Aufruf
Volumenpreise verfügbar
Priorisierter Support

Preise zzgl. MwSt. Jederzeit im Abrechnungsportal kündbar.

Mehr als 100.000 Aufrufe, ein White-Label-Widget oder ein SLA? Sprechen Sie uns an.

Kontakt aufnehmen

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.

In Minuten integriert

Eine Anfrage rein, eine vollständige Gehaltsaufschlüsselung raus. Kein SDK nötig.

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

Endpunkte

Neun Endpunkte: Berechnungen, Steuerdaten und Marktkontext.

POST/api/v1/calculate

Netto, Arbeitgeberkosten & detaillierte Aufschlüsselung für ein Land

POST/api/v1/compare

Dieselbe Berechnung für mehrere Länder auf einmal

POST/api/v1/reverse

Wunsch-Netto rein, benötigtes Brutto raus — mit vollständiger Aufschlüsselung

GET/api/v1/countries

Unterstützte Länder & Datenaktualität

GET/api/v1/brackets/:country

Steuerstufen & Sozialabgabensätze

GET/api/v1/rates

Aktuelle EUR-Wechselkurse für alle unterstützten Währungen

GET/api/v1/holidays/:country

Gesetzliche Feiertage pro Land und Jahr

GET/api/v1/percentiles/:country

Wo ein Gehalt in der Verteilung des Landes liegt (p10–p99)

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

Miet-, Lebensmittel- und Kaufkraft-Indizes pro Land

Jeder Endpunkt antwortet auf einen kostenlosen Schlüssel — 100 Aufrufe pro Monat. Bezahlte Tarife bringen mehr Volumen, nicht mehr Endpunkte.

Dokumentation

Alles für die Integration: Authentifizierung, Parameter und Fehlerbehandlung.

Authentifizierung

Senden Sie Ihren API-Schlüssel als Bearer-Token im Authorization-Header. Schlüssel erstellen und verwalten Sie im Dashboard. /developers/keys

Authorization: Bearer nsk_live_…

Request-Parameter

Body-Felder für POST /api/v1/calculate und /api/v1/compare.

countrystringerforderlich

Zweistelliger Ländercode, z. B. "de"

countriesstring[]optional

Array von Ländercodes (nur /compare, ersetzt country)

grossnumbererforderlich

Bruttogehalt in der Landeswährung

periodstringerforderlich

Zeitraum des Bruttobetrags: "monthly" oder "yearly"

yearnumberoptional

Steuerjahr: 2025, 2026 oder 2027 (Standard 2026). 2027 ist erst teilweise beschlossen — siehe yearDataStatus in der Antwort.

Response-Felder

netnumber

Nettogehalt pro Zeitraum

employerCostnumber

Gesamtkosten der Beschäftigung: brutto + Arbeitgeberbeiträge

effectiveRatenumber

Effektiver Steuersatz in Prozent

currencystring

Landeswährung aller Beträge

breakdownarray

Detaillierte Steuerposten: Einkommensteuer, Sozialabgaben und mehr

Rückwärtsrechnung

POST/api/v1/reverse

Senden Sie das gewünschte Netto des Kandidaten; erhalten Sie das nötige Brutto und die Arbeitgeberkosten.

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

Feiertage

GET /api/v1/holidays/:country

Gesetzliche Feiertage mit lokalisierten Namen. Query-Parameter: year (2026 oder 2027) und lang (11 Sprachen).

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

Fehler

401

Fehlender oder ungültiger API-Schlüssel

422

Validierung fehlgeschlagen: Land nicht unterstützt, Betrag oder Jahr ungültig

429

Monatskontingent überschritten

Eine Gehaltsberechnungs-API für Payroll-, EOR- und Finanzteams

Die NetSalary API verwandelt Bruttogehälter in Nettogehalt und Arbeitgeber-Gesamtkosten nach den Steuerregeln 2026 von 18 Ländern — 16 in Europa sowie Brasilien und die VAE — inklusive Einkommensteuerstufen, Sozialabgaben und Arbeitgeberkosten. Es ist dieselbe Engine hinter dem NetSalary-Rechner, bereitgestellt als einfache REST-API für Payroll-Software, Employer-of-Record-Plattformen, Relocation-Tools und HR-Systeme.

Was Teams damit bauen

Payroll & Buchhaltung

Zeigen Sie Mitarbeitern das exakte Netto und dem Finanzteam die wahren Kosten jeder Einstellung vor dem Gehaltslauf.

EOR & globales Recruiting

Kalkulieren Sie die Gesamtbeschäftigungskosten in 18 Ländern mit einer Anfrage, wenn Sie internationale Angebote bepreisen.

Relocation & Mobilität

Vergleichen Sie das Nettogehalt zwischen Ländern, damit Kandidaten sehen, was ein Angebot nach Steuern wirklich wert ist.

Jobbörsen & Fintech

Reichern Sie Anzeigen und Finanzprodukte mit Nettogehalts-Schätzungen und Feiertagskalendern an.

Häufig gestellte Fragen

Was ist eine Nettogehalts-API?

Ein REST-Service, der Bruttogehalt in Netto umrechnet. Sie senden Land, Bruttobetrag und Zeitraum; die API liefert Netto, Arbeitgeber-Gesamtkosten, den effektiven Steuersatz und eine detaillierte Aufschlüsselung von Einkommensteuer und Sozialabgaben.

Welche Länder unterstützt die Gehalts-API?

Achtzehn Länder: Deutschland, Großbritannien, Niederlande, Spanien, Polen, Schweiz, Irland, Portugal, Schweden, Norwegen, Finnland, Estland, Lettland, Litauen, Österreich, Belgien, Brasilien und die VAE — mit Steuerregeln für 2025 und 2026.

Wie genau sind die Berechnungen?

Die Regeln jedes Landes werden anhand der offiziellen Steuerstufen und Sozialabgaben 2026 gepflegt, und jede Antwort enthält das Datum der letzten Überprüfung. Ergebnisse sind Schätzungen für reguläres Arbeitseinkommen und ersetzen keine professionelle Steuerberatung.

Berechnet sie auch die Arbeitgeberkosten?

Ja. Jede Berechnung liefert sowohl das Netto des Mitarbeiters als auch die Gesamtkosten der Beschäftigung — Brutto plus Arbeitgeber-Sozialabgaben — genau das, was Finanzteams für Budgetierung und internationale Angebote brauchen.

Gibt es einen Gratis-Tarif?

Ja — 100 Aufrufe pro Monat, mit allen Endpunkten und allen 18 Ländern, sodass Sie die komplette Integration vor dem Kauf bauen können. Die bezahlten Tarife unterscheiden sich nur im Volumen: 29 € pro Monat für 2.500 Aufrufe, 99 € für 10.000 und 299 € für 100.000.

Wie starte ich?

Erstellen Sie einen kostenlosen API-Schlüssel im Dashboard und senden Sie die erste Anfrage mit einem einzigen curl-Befehl. Ohne SDK, Vertrag oder Sales-Call.

Eine Gehaltsberechnungs-API für Payroll-, EOR- und Finanzteams