version-tax-withholding-company-employeeId-withholdings-get

GET

Tax Withholding

Retrieve employee federal, state and local tax withholding information. 

 

{
  "employeeId":"string",
  "effectiveDate":"datetime",
  "FedTaxWithholdings":{
    "addlAmount":"number",
    "addlExempts":"int",
    "allowancesRequested":"int",
    "desc":"string",
    "payDedCode":"string",
    "exempt":"boolean",
    "marriedFileSingle":"boolean",
    "maritalStatus":"string",
    "maritalStatusAllowance":"string",
    "percentageGrossList":"string",
    "percentageGross":"string",
    "nonResidentIsDeclared":"boolean",
    "type":"string",
    "exemptNoAppendTxt":"string",
    "dependentAllowances":"string",
    "additionalAllowances":"string",
    "annualExemptionAmount":"string",
    "maritalAllowance":"string",
    "payControlOrg":"string",
    "localTaxNames":"string",
    "relatedEntity":"string"
  },
  "StateTaxWithholdings":[
    {
      "addlAmount":"number",
      "addlExempts":"int",
      "allowancesRequested":"int",
      "desc":"string",
      "payDedCode":"string",
      "exempt":"boolean",
      "marriedFileSingle":"boolean",
      "maritalStatus":"string",
      "maritalStatusAllowance":"string",
      "percentageGrossList":"string",
      "percentageGross":"string",
      "nonResidentIsDeclared":"boolean",
      "type":"string",
      "exemptNoAppendTxt":"string",
      "dependentAllowances":"string",
      "additionalAllowances":"string",
      "annualExemptionAmount":"string",
      "maritalAllowance":"string",
      "payControlOrg":"string",
      "localTaxNames":"string",
      "relatedEntity":"string"
    }
  ],
  "LocalTaxWithholdings":[
    {
      "addlAmount":"number",
      "addlExempts":"int",
      "allowancesRequested":"int",
      "desc":"string",
      "payDedCode":"string",
      "exempt":"boolean",
      "marriedFileSingle":"boolean",
      "maritalStatus":"string",
      "maritalStatusAllowance":"string",
      "percentageGrossList":"string",
      "percentageGross":"string",
      "nonResidentIsDeclared":"boolean",
      "type":"string",
      "exemptNoAppendTxt":"string",
      "dependentAllowances":"string",
      "additionalAllowances":"string",
      "annualExemptionAmount":"string",
      "maritalAllowance":"string",
      "payControlOrg":"string",
      "localTaxNames":"string",
      "relatedEntity":"string"
    }
  ]
}
Field Description

employeeId

TriNet employee ID

effectiveDate

Date the tax withholding became effective

FedTaxWithholdings

 

addlAmount

Amount of any additional tax withholding

addlExempts

Please ignore – not valid for federal

allowancesRequested

Number of allowances/exemptions

Desc

Description of the type of tax

payDedCode

Code identifying if the tax is federal

Exempt

Whether or not the employee is exempt from tax withholding

marriedFileSingle

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

maritalStatus

Marital status

maritalStatusAllowance

Please ignore – not valid for federal

percentageGrossList

Please ignore – not valid for federal

percentageGross

Please ignore – not valid for federal

nonResidentIsDeclared

Please ignore – not valid for federal

Type

Whether it’s for federal, state or local taxes

exemptNoAppendTxt

Please ignore – not valid for federal

dependentAllowances

Please ignore – not valid for federal

additionalAllowances

Please ignore – not valid for federal

annualExemptionAmount

Please ignore – not valid for federal

StateTaxWithholding

 

addlAmount

Amount of any additional tax withholding

addlExempts

Additional exemptions

allowancesRequested

Number of allowances/exemptions

Desc

Description of the type of tax

payDedCode

Code identifying the state

Exempt

Whether or not the employee is exempt from tax withholding

marriedFileSingle

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

maritalStatus

Marital status

maritalStatusAllowance

 

percentageGrossList

 

percentageGross

 

nonResidentIsDeclared

Whether or not the employee is a nonresident alien

Type

 

exemptNoAppendTxt

 

dependentAllowances

 

additionalAllowances

 

annualExemptionAmount

 

LocalTaxWithholdings

 

addlAmount

Amount of any additional tax withholding

addlExempts

 

allowancesRequested

Number of allowances/exemptions

Desc

Description of the type of tax

payDedCode

Code identifying the city or county for local tax

Exempt

Whether or not the employee is exempt from tax withholding

marriedFileSingle

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

maritalStatus

Marital status

maritalStatusAllowance

 

percentageGrossList

 

percentageGross

 

nonResidentIsDeclared

 

Type

 

exemptNoAppendTxt

 

dependentAllowances

 

additionalAllowances

 

annualExemptionAmount

 

Resource URL

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

Request Body

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:

Scope:

hr-personal-read

Working...