Federal Tax

Endpoint: https://api.paychex.com/workers/{workerId}/federaltax

**This resource is only available for workers who's status is IN_PROGRESS**

Verbs supported: GET & POST & PATCH

GET: Federal tax setup for worker.

POST: Add federal tax setup for a worker.

PATCH: Update the federal tax setup for a worker.

Request:

Element NameTypeDescription
workerId stringThe id assigned to the worker that workers are being requested for.

Response:

VerbProfileDescription
GEThttp://api.paychex.com/worker/federaltax/v1Default federal tax profile.
POSThttp://api.paychex.com/worker/federaltax/v1Default federal tax profile.
PATCH-Default federal tax profile.

 

Response

Profile: Federal Tax

The representational state of the an In-Progress workers federal tax setup.
Element NameTypeDescription
taxIdstringThe ID for the federal tax item.
fedFilingStatusstringFiling status.
  • SINGLE
  • MARRIED
  • MARRIED_WITHHOLD_SINGLE
 
fedAllowancesstringTotal number of allowances.
fedDoNotWithholdstringShould federal taxes not be withheld.
  • Y
  • N
fedWithHoldingAmountstringAdditional dollar amount to withhold each check.

 

{
  "content": [
    {
            "taxId": "3520000100329425",
            "fedFilingStatus": "SINGLE",
            "fedAllowances": "1",
            "fedDoNotWithhold": "N",
            "fedWithHoldingAmount": "100"
        }
  ]
}