API Docs
Login for full accessGet a demo

Calculate 401k paycheck

post
https://calculators.symmetry.com/api/calculators/401k

Performs paycheck calculation with 401k retirement contributions

Query Params
string
enum

Report type to generate (requires valid print object)

boolean
Defaults to false

Include calculator object in response

boolean
Defaults to false

Include itemized tax details

Body Params

401k calculator configuration

number
required
≥ 0

Additional amount to withhold for federal taxes

date-time

Date of the paycheck calculation

number

Annual contribution limit for 401k

number
≥ 0

Deductions amount from W-4 2020+ Step 4b

number
≥ 0

Dependent amount from W-4 2020+ Step 3

number

Employee's 401k contribution amount

string
enum

Type of employee contribution calculation

Allowed:
number

Employer's matching contribution amount

string
enum

Type of employer contribution calculation

Allowed:
boolean

Whether the employee is exempt from federal tax withholding

boolean

Whether the employee is exempt from FICA (Social Security) tax

boolean

Whether the employee is exempt from Medicare tax

int32
required
≥ 0

Number of federal tax allowances claimed

string
enum

Federal tax filing status

Allowed:
string
enum

Federal filing status for W-4 2020+ form

Allowed:
number
required
≥ 0

Gross pay amount for the calculation period

string
enum

Method used to calculate gross pay

Allowed:
number
required
≥ 0

Year-to-date gross pay

boolean

Whether employee is age 50 or older (allows catch-up contributions)

otherIncome
array of objects

List of other income sources (imputed income)

otherIncome
number
≥ 0

Other income amount from W-4 2020+ Step 4a

string
enum

Frequency of pay periods

presetDeductions
array of objects

List of preset custom deductions

presetDeductions
presetImputed
array of objects

List of preset imputed income

presetImputed
print
object

Print object for PDF report generation

boolean

Whether to round federal withholding amounts

string
enum
required

Two-letter state abbreviation where the employee works

stateInfo
object

State-specific parameters for the calculation

boolean

Whether employee has two jobs (W-4 2020+ Step 2c)

voluntaryDeductions
array of objects

List of voluntary deductions (401k, HSA, custom deductions, etc.)

voluntaryDeductions
boolean

Whether using W-4 form from 2020 or later (vs. pre-2020 W-4)

Responses

422

Unprocessable Entity

500

Internal Server Error

Updated about 2 months ago

Language
Credentials
Header
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated about 2 months ago 













































  Jump to top