API — публичный интерфейс калькулятора НДФЛ

Здесь собрана документация по открытому API сервиса для расчёта НДФЛ по прогрессивной шкале. Данные не сохраняются, вычисления выполняются в реальном времени.

Текущая версия API v1

Публичные методы

POST /api/v1/calc

Открытый расчёт НДФЛ

Полный запрос:

{
  "gross_salary": 120000,
  "territorial_multiplier": 120,
  "northern_coefficient": 150
}

Минимальный запрос:

{"gross_salary": 120000}

Пример ответа:

{
  "gross_salary": 120000,
  "territorial_multiplier": 120,
  "northern_coefficient": 150,

  "annual_tax_amount": 17160,
  "annual_gross_income": 180000,
  "annual_net_income": 162840,

  "monthly_details": [
    {
      "month": "2024-01-01T00:00:00Z",
      "monthly_gross_income": 180000,
      "monthly_net_income": 162840,
      "monthly_tax_amount": 17160,

      "annual_gross_income": 180000,
      "annual_net_income": 162840,
      "annual_tax_amount": 17160
    }
  ]
}

Примеры вызова API

curl:

curl -X POST https://calculator-ndfl.ru/api/v1/calc \
  -H "Content-Type: application/json" \
  -d '{"gross_salary": 120000}'

JavaScript:

fetch("/api/internal server error