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.

ИнструментыAPI

NetSalary APIv1

Зарплата на руки и полные расходы работодателя в 18 странах — один REST-запрос

Получите бесплатный API-ключ

Состояние APIПроверка

Проверка

Проверка измеряет весь путь туда и обратно вместе со временем сети; серверные цифры — это только время обработки, без сети.

Тарифы

Начните бесплатно, переходите выше с ростом объёма.

2 месяца бесплатно

Бесплатный

0 € навсегда

100 запросов / мес.

Все эндпоинты, ничего не закрыто
Все 18 стран
Нетто + расходы работодателя
Достаточно, чтобы оценить до покупки

Получить ключ

Solo

29 € /мес.

2 500 запросов / мес.

Всё из тарифа «Бесплатный»
25× объёма вызовов бесплатного тарифа
0.0116 € за вызов
Поддержка по почте

Самый популярный

Starter

99 € /мес.

10 000 запросов / мес.

Всё из Solo
100× объёма вызовов бесплатного тарифа
0.0099 € за вызов

Scale

299 € /мес.

100 000 запросов / мес.

Всё из Starter
1 000× объёма вызовов бесплатного тарифа
0.0030 € за вызов
Доступны цены за объём
Приоритетная поддержка

Цены без НДС. Отменить можно в любой момент в биллинг-портале.

Нужно больше 100 000 запросов, white-label виджет или SLA? Напишите нам.

Связаться с нами

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.

Интеграция за минуты

Один запрос на входе — полная детализация зарплаты на выходе. 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"}'

Эндпоинты

Девять эндпоинтов: расчёты, налоговые данные и рыночный контекст.

POST/api/v1/calculate

Нетто, расходы работодателя и детализация для одной страны

POST/api/v1/compare

Тот же расчёт сразу для нескольких стран

POST/api/v1/reverse

Желаемое нетто на входе, необходимое брутто на выходе — с полной детализацией

GET/api/v1/countries

Поддерживаемые страны и актуальность данных

GET/api/v1/brackets/:country

Налоговые шкалы и ставки социальных взносов

GET/api/v1/rates

Актуальные курсы EUR для всех поддерживаемых валют

GET/api/v1/holidays/:country

Государственные праздники по странам и годам

GET/api/v1/percentiles/:country

Где зарплата находится в распределении по стране (p10–p99)

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

Индексы аренды, продуктов и покупательной способности по странам

Любой эндпоинт отвечает на бесплатный ключ — 100 вызовов в месяц. Платные тарифы добавляют объём, а не эндпоинты.

Документация

Всё для интеграции: аутентификация, параметры и обработка ошибок.

Аутентификация

Отправляйте API-ключ как Bearer-токен в заголовке Authorization. Ключи создаются и управляются в панели. /developers/keys

Authorization: Bearer nsk_live_…

Параметры запроса

Поля тела для POST /api/v1/calculate и /api/v1/compare.

countrystringобязательный

Двухбуквенный код страны, напр. "de"

countriesstring[]необязательный

Массив кодов стран (только /compare, заменяет country)

grossnumberобязательный

Зарплата брутто в местной валюте страны

periodstringобязательный

Период суммы брутто: "monthly" или "yearly"

yearnumberнеобязательный

Налоговый год: 2025, 2026 или 2027 (по умолчанию 2026). 2027 год принят лишь частично — см. yearDataStatus в ответе.

Поля ответа

netnumber

Зарплата на руки за период

employerCostnumber

Полная стоимость найма: брутто + взносы работодателя

effectiveRatenumber

Эффективная налоговая ставка в процентах

currencystring

Местная валюта всех сумм

breakdownarray

Детализация налогов: подоходный налог, социальные взносы и другое

Обратный расчёт

POST/api/v1/reverse

Отправьте нетто, которое хочет кандидат; получите необходимое брутто и расходы работодателя.

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

Праздничные дни

GET /api/v1/holidays/:country

Государственные праздники с локализованными названиями. Параметры: year (2026 или 2027) и lang (11 языков).

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

Ошибки

401

Отсутствующий или неверный API-ключ

422

Ошибка валидации: неподдерживаемая страна, неверная сумма или год

429

Месячная квота исчерпана

API расчёта зарплаты для отделов расчёта зарплаты, EOR-провайдеров и финансовых команд

NetSalary API превращает зарплату брутто в зарплату на руки и полные расходы работодателя по налоговым правилам 2026 года для 18 стран — 16 в Европе, а также Бразилии и ОАЭ, — с учётом шкал подоходного налога, социальных взносов и отчислений работодателя. Это тот же движок, что стоит за калькулятором NetSalary, доступный как простой REST API для зарплатного ПО, EOR-платформ, инструментов релокации и HR-систем.

Что команды строят на нём

Зарплата и бухгалтерия

Показывайте сотрудникам точное нетто, а финансовой команде — реальную стоимость каждого найма до расчёта зарплаты.

EOR и глобальный найм

Рассчитывайте полную стоимость найма в 18 странах одним запросом при оценке международных офферов.

Релокация и мобильность

Сравнивайте зарплату на руки между странами, чтобы кандидаты видели реальную ценность оффера после налогов.

Джоб-борды и финтех

Обогащайте вакансии и финансовые продукты оценками нетто и календарями праздничных дней.

Частые вопросы

Что такое API зарплаты нетто?

REST-сервис, преобразующий брутто в нетто. Вы отправляете страну, сумму брутто и период; API возвращает нетто, полные расходы работодателя, эффективную налоговую ставку и детализацию подоходного налога и социальных взносов.

Какие страны поддерживает API?

Восемнадцать стран: Германия, Великобритания, Нидерланды, Испания, Польша, Швейцария, Ирландия, Португалия, Швеция, Норвегия, Финляндия, Эстония, Латвия, Литва, Австрия, Бельгия, Бразилия и ОАЭ — с налоговыми правилами 2025 и 2026 годов.

Насколько точны расчёты?

Правила каждой страны поддерживаются в соответствии с официальными налоговыми ставками и взносами 2026 года, и каждый ответ содержит дату последней проверки правил. Результаты — оценки для стандартного дохода по найму и не заменяют профессиональную налоговую консультацию.

Считает ли он расходы работодателя помимо нетто?

Да. Каждый расчёт возвращает и нетто сотрудника, и полную стоимость найма — брутто плюс взносы работодателя — именно то, что нужно финансовым командам для бюджетирования и оценки международных наймов.

Есть ли бесплатный тариф?

Да — 100 вызовов в месяц, со всеми эндпоинтами и всеми 18 странами, так что всю интеграцию можно собрать до оплаты. Платные тарифы различаются только объёмом: 29 € в месяц за 2500 вызовов, 99 € за 10 000 и 299 € за 100 000.

С чего начать?

Создайте бесплатный API-ключ в панели и отправьте первый запрос одной командой curl. Без SDK, договора и звонка с отделом продаж.

API расчёта зарплаты для отделов расчёта зарплаты, EOR-провайдеров и финансовых команд