Skip to main content
POST
/
gross-to-net
Calculate gross-to-net payroll
curl --request POST \
  --url https://api.fluxpayroll.ai/v1/gross-to-net \
  --header 'Content-Type: application/json' \
  --data '{
  "payroll": {
    "date": "2025-08-01",
    "frequency": "monthly"
  },
  "employer": {
    "address": {
      "state": "MCX"
    },
    "workSchedule": {
      "workDays": [
        "MONDAY"
      ],
      "workHoursInDay": 8,
      "workDaysInWeek": 5
    },
    "contribution_rates": [
      {
        "rate_type": "accident_rate",
        "rate": 0.1
      }
    ]
  },
  "employees": [
    {
      "id": "emp1",
      "work_address": {
        "state": "MCX"
      },
      "earnings": [
        {
          "earning_type": "gross_salary",
          "amount": 41666.67
        }
      ],
      "deductions": [
        {
          "deduction_type": "<string>",
          "amount": 1
        }
      ],
      "employer_contributions": [
        {
          "contribution_type": "<string>",
          "amount": 1
        }
      ],
      "historic_amounts": {
        "earnings": [
          {
            "earning_type": "gross_salary",
            "ytd_amount": 0
          }
        ],
        "deductions": [
          {
            "deduction_type": "social_security",
            "ytd_amount": 0
          }
        ],
        "employer_contributions": [
          {
            "contribution_type": "social_security",
            "ytd_amount": 0
          }
        ],
        "employee_tax_payments": [
          {
            "tax_type": "income_tax",
            "ytd_amount": 0
          }
        ],
        "employer_tax_payments": [
          {
            "tax_type": "income_tax",
            "ytd_amount": 0
          }
        ]
      }
    }
  ]
}'
{
  "employees": [
    {
      "employee_id": "emp1",
      "gross_pay": 46666.67,
      "total_employee_tax_amount": 3274.19,
      "total_deductions": 2193.33,
      "total_employer_cost": 14746.66,
      "net_pay": 40749.15,
      "employee_deductions": [
        {
          "deduction_type": "social_security",
          "deduction_amount": 2193.33,
          "is_pretax": true
        }
      ],
      "earnings": [
        {
          "earning_type": "gross_salary",
          "earning_amount": 41666.67,
          "is_taxed": true
        }
      ],
      "employer_contributions": [
        {
          "contribution_type": "social_security",
          "contribution_amount": 11013.33,
          "is_imputed_income": false
        }
      ],
      "employee_taxes": [
        {
          "tax_type": "income_tax",
          "tax_amount": 3274.19
        }
      ],
      "employer_taxes": [
        {
          "tax_type": "state_payroll_tax",
          "tax_amount": 1400
        }
      ]
    }
  ],
  "summary": {
    "total_net_pay": 40749.15,
    "total_gross_pay": 46666.67,
    "total_employer_taxes": [
      {
        "tax_type": "state_payroll_tax",
        "tax_amount": 1400
      }
    ],
    "total_employee_taxes": [
      {
        "tax_type": "income_tax",
        "tax_amount": 3274.19
      }
    ],
    "total_employer_contributions": [
      {
        "contribution_type": "social_security",
        "contribution_amount": 11013.33,
        "is_imputed_income": false
      }
    ],
    "total_employee_deductions": [
      {
        "deduction_type": "social_security",
        "deduction_amount": 2193.33,
        "is_pretax": true
      }
    ],
    "total_employee_earnings": [
      {
        "earning_type": "gross_salary",
        "earning_amount": 41666.67,
        "is_taxed": true
      }
    ]
  }
}

Body

application/json
payroll
object
required
employer
object
required
employees
object[]
required
Minimum length: 1

Response

Successful payroll calculation

employees
object[]
required
summary
object
required