version-tax-withholding-company-employeeId-withholdings-put

PUT

Tax Withholding

Retrieve employee federal, state and local tax withholding information. 

 

{
  "effectiveDate":"YYYY-MM-DD",
  "FedTaxWithholdings":[
    {
      "addlAmount":"number",
      "addlExempts":"number",
      "allowancesRequested":"integer",
      "payDedCode":"$$US",
      "relatedEntity":"$$US",
      "exempt":"boolean",
      "marriedFileSingle":"boolean",
      "maritalStatus":"M#S",
      "payControlOrg":"string",
      "nonResidentIsDeclared":"boolean",
      "exemptNoAppendTxt":"string"
    }
  ],
  "StateTaxWithholdings":[
    {
      "addlAmount":"number",
      "addlExempts":"number",
      "allowancesRequested":"integer",
      "payDedCode":"string",
      "relatedEntity":"$$US",
      "exempt":"booolean",
      "marriedFileSingle":"boolean",
      "maritalStatus":"H#M#S",
      "payControlOrg":"string",
      "nonResidentIsDeclared":"boolean",
      "exemptNoAppendTxt":"string"
    }
  ]
}
Field Req Description

effectiveDate

yes

Date the tax withholding became effective

FedTaxWithholdings

 

 

addlAmount

no

Amount of any additional tax withholding

addlExempts

no

Please ignore – not valid for federal

allowancesRequested

yes

Number of allowances/exemptions

payDedCode

yes

Code identifying if the tax is federal

Exempt

yes

Whether or not the employee is exempt from tax withholding

marriedFileSingle

no

Whether or not the employee is married but filing as single for tax purposes

maritalStatus

yes

Marital status

nonResidentIsDeclared

no

Please ignore – not valid for federal

exemptNoAppendTxt

no

Please ignore – not valid for federal

StateTaxWithholding

 

 

addlAmount

no

Amount of any additional tax withholding

addlExempts

no

Additional exemptions

allowancesRequested

yes

Number of allowances/exemptions

payDedCode

yes

Code identifying the state

Exempt

yes

Whether or not the employee is exempt from tax withholding

marriedFileSingle

no

Whether or not the employee is married but filing as single for tax purposes

maritalStatus

yes

Marital status

nonResidentIsDeclared

no

Whether or not the employee is a nonresident alien

exemptNoAppendTxt

no

 

Resource URL

https://api.trinet.com /{version}/tax-withholding/{company}/{employeeId}/withholdings

Body Parameters


Name Values Description
body
(required)

Request Body

Field Req Description

effectiveDate

yes

Date the tax withholding became effective

FedTaxWithholdings

 

 

addlAmount

no

Amount of any additional tax withholding

addlExempts

no

Please ignore – not valid for federal

allowancesRequested

yes

Number of allowances/exemptions

payDedCode

yes

Code identifying if the tax is federal

Exempt

yes

Whether or not the employee is exempt from tax withholding

marriedFileSingle

no

Whether or not the employee is married but filing as single for tax purposes

maritalStatus

yes

Marital status

nonResidentIsDeclared

no

Please ignore – not valid for federal

exemptNoAppendTxt

no

Please ignore – not valid for federal

StateTaxWithholding

 

 

addlAmount

no

Amount of any additional tax withholding

addlExempts

no

Additional exemptions

allowancesRequested

yes

Number of allowances/exemptions

payDedCode

yes

Code identifying the state

Exempt

yes

Whether or not the employee is exempt from tax withholding

marriedFileSingle

no

Whether or not the employee is married but filing as single for tax purposes

maritalStatus

yes

Marital status

nonResidentIsDeclared

no

Whether or not the employee is a nonresident alien

exemptNoAppendTxt

no

 

HTTP Basic

OAuth 2.0

API Key

Reset

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Response Error Details

  • HTTP Code
    Error Code
    Description
  • 400

  • 401

  • 403

  • 404

Resource Summary

Security:

Content Type:

application/json

Scope:

hr-personal-write

Working...