Show employee state taxes

Returns the authenticated employee's saved US state tax withholding answers for a
single jurisdiction (e.g. NY), keyed like that jurisdiction's
global_payroll_state_taxes form so they can pre-fill it. state_taxes is null
when nothing has been saved yet.

Returns a 404 when the employment has no state tax form for the jurisdiction.

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.

Token typeCategoryRead only ScopeWrite only Scope (read access implicit)
Employee-scoped access tokenManage employments (employments)View personal details (personal_detail:read)Manage personal details (personal_detail:write)
Company-scoped access tokenManage employments (employments)View personal details (personal_detail:read)-
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Two-letter US state/jurisdiction code

Responses

Callback
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json