Body
application/json
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
}
]
}
}Calculates net pay, taxes, deductions, and employer contributions based on gross salary and other earnings
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
}
]
}
}