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.

HerramientasAPI

NetSalary APIv1

Salario neto y coste total del empleador en 18 países — una sola llamada REST

Consigue tu clave API gratis

Estado de la APIComprobando

Comprobando

El sondeo mide el trayecto completo de ida y vuelta e incluye el tiempo de red; las cifras del servidor son solo tiempo de procesamiento y lo excluyen.

Precios

Empieza gratis y mejora cuando crezca tu volumen.

2 meses gratis

Gratis

0 € para siempre

100 llamadas / mes

Todos los endpoints, sin bloqueos
Los 18 países
Neto + coste del empleador
Suficiente para evaluarla antes de pagar

Obtener clave

Solo

29 € /mes

2500 llamadas / mes

Todo lo del plan Gratis
25× el volumen del plan gratuito
0.0116 € por llamada
Soporte por correo

Más popular

Starter

99 € /mes

10.000 llamadas / mes

Todo lo del plan Solo
100× el volumen del plan gratuito
0.0099 € por llamada

Scale

299 € /mes

100.000 llamadas / mes

Todo lo del plan Starter
1000× el volumen del plan gratuito
0.0030 € por llamada
Precios por volumen disponibles
Soporte prioritario

Precios sin IVA. Cancela cuando quieras desde el portal de facturación.

¿Necesitas más de 100.000 llamadas, un widget de marca blanca o un SLA? Habla con nosotros.

Contáctanos

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.

Intégralo en minutos

Una solicitud de entrada, un desglose salarial completo de salida. Sin 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"}'

Endpoints

Nueve endpoints: cálculos, datos fiscales y contexto de mercado.

POST/api/v1/calculate

Salario neto, coste del empleador y desglose detallado para un país

POST/api/v1/compare

El mismo cálculo para varios países a la vez

POST/api/v1/reverse

Neto deseado de entrada, bruto necesario de salida — con desglose completo

GET/api/v1/countries

Países disponibles y actualidad de los datos

GET/api/v1/brackets/:country

Tramos fiscales y cotizaciones sociales

GET/api/v1/rates

Tipos de cambio EUR en tiempo real para todas las monedas soportadas

GET/api/v1/holidays/:country

Días festivos públicos por país y año

GET/api/v1/percentiles/:country

Dónde se sitúa un salario en la distribución del país (p10–p99)

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

Índices de alquiler, cesta de la compra y poder adquisitivo por país

Todos los endpoints responden a una clave gratuita: 100 llamadas al mes. Los planes de pago añaden volumen, no endpoints.

Documentación

Todo lo necesario para integrar: autenticación, parámetros y manejo de errores.

Autenticación

Envía tu clave API como token Bearer en la cabecera Authorization. Crea y gestiona claves en el panel. /developers/keys

Authorization: Bearer nsk_live_…

Parámetros de la solicitud

Campos del cuerpo para POST /api/v1/calculate y /api/v1/compare.

countrystringobligatorio

Código de país de dos letras, p. ej. "de"

countriesstring[]opcional

Array de códigos de país (solo /compare, sustituye a country)

grossnumberobligatorio

Salario bruto en la moneda local del país

periodstringobligatorio

Periodo del importe bruto: "monthly" o "yearly"

yearnumberopcional

Año fiscal: 2025, 2026 o 2027 (por defecto 2026). 2027 solo está aprobado en parte — véase yearDataStatus en la respuesta.

Campos de respuesta

netnumber

Salario neto por periodo

employerCostnumber

Coste total de emplear: bruto + cotizaciones del empleador

effectiveRatenumber

Tipo impositivo efectivo en porcentaje

currencystring

Moneda local de todos los importes

breakdownarray

Líneas fiscales detalladas: impuesto sobre la renta, cotizaciones sociales y más

Cálculo inverso

POST/api/v1/reverse

Envía el neto que quiere el candidato; recibe el bruto que debes ofrecer y lo que te costará como empleador.

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

Días festivos

GET /api/v1/holidays/:country

Festivos públicos con nombres localizados. Parámetros: year (2026 o 2027) y lang (11 idiomas).

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

Errores

401

Clave API ausente o no válida

422

Validación fallida: país no soportado, importe o año incorrectos

429

Cuota mensual superada

Una API de cálculo salarial para equipos de nóminas, EOR y finanzas

NetSalary API convierte salarios brutos en salario neto y coste total del empleador usando las reglas fiscales de 2026 de 18 países — 16 en Europa, más Brasil y los EAU —: tramos del impuesto sobre la renta, cotizaciones sociales y cargas patronales incluidas. Es el mismo motor de la calculadora NetSalary, expuesto como una API REST sencilla para software de nóminas, plataformas EOR, herramientas de reubicación y sistemas de RR. HH.

Qué construyen los equipos con ella

Nóminas y contabilidad

Muestra a los empleados su neto exacto y a finanzas el coste real de cada contratación antes de ejecutar la nómina.

EOR y contratación global

Cotiza el coste total de empleo en 18 países con una sola llamada al valorar ofertas internacionales.

Reubicación y movilidad

Compara el salario neto entre países para que los candidatos vean cuánto vale realmente una oferta tras impuestos.

Portales de empleo y fintech

Enriquece anuncios y productos financieros con estimaciones de salario neto y calendarios de festivos.

Preguntas frecuentes

¿Qué es una API de salario neto?

Un servicio REST que convierte el salario bruto en neto. Envías país, importe bruto y periodo; la API devuelve el neto, el coste total del empleador, el tipo efectivo y el desglose detallado de impuestos y cotizaciones sociales.

¿Qué países admite la API salarial?

Dieciocho países: Alemania, Reino Unido, Países Bajos, España, Polonia, Suiza, Irlanda, Portugal, Suecia, Noruega, Finlandia, Estonia, Letonia, Lituania, Austria, Bélgica, Brasil y EAU — con reglas fiscales de 2025 y 2026.

¿Qué precisión tienen los cálculos?

Las reglas de cada país se mantienen según los tramos fiscales y cotizaciones oficiales de 2026, y cada respuesta incluye la fecha de la última revisión. Los resultados son estimaciones para rentas de trabajo estándar y no sustituyen el asesoramiento fiscal profesional.

¿Calcula también el coste del empleador además del neto?

Sí. Cada cálculo devuelve el neto del empleado y el coste total de emplear — bruto más cotizaciones patronales — justo lo que los equipos financieros necesitan para presupuestar y cotizar contrataciones internacionales.

¿Hay un plan gratuito?

Sí: 100 llamadas al mes, con todos los endpoints y los 18 países incluidos, así que puedes montar la integración entera antes de pagar. Los planes de pago solo se diferencian en volumen: 29 € al mes por 2.500 llamadas, 99 € por 10.000 y 299 € por 100.000.

¿Cómo empiezo?

Crea una clave API gratuita en el panel y envía tu primera solicitud con un solo comando curl. Sin SDK, contrato ni llamada comercial.

Una API de cálculo salarial para equipos de nóminas, EOR y finanzas