Returns the authenticated employee's saved US federal tax (W-4) answers, keyed like the global_payroll_federal_taxes form so they can pre-fill it. federal_taxes is null when nothing has been saved yet.

Available for US Global Payroll employees once they reach the post-enrollment state. Calls made before then return a 404.

Authentication

This endpoint accepts any one of the following token types:

• Employee-scoped access token (OAuth2Assertion) — obtained through the urn:ietf:params:oauth:grant-type:jwt-bearer grant. See OAuth Assertion.
• Company-scoped access token (OAuth2AuthorizationCode) — obtained by the employee through the Authorization Code flow or the Refresh Token flow. See Authentication for partners.

Scopes

Any one of the scopes in a token type's row is enough. all:read and all:write work too.

{
  "data": {
    "federal_taxes": {
      "deductions": 99900,
      "dependents_amount": 500,
      "extra_withholding": 1200,
      "filing_status": "Married",
      "other_income": 56700,
      "two_jobs": "yes"
    }
  }
}