CHcheckhq

[Sandbox] Simulate publishing an employee tax statement

Changed on

Simulate publishing a draft employee tax statement to the employee in sandbox. Sandbox-only: in production this endpoint returns a 404.

The statement must be in draft publication status and must have statement data (refresh the company's filings if needed). Physical mail is not sent. Returns the employee tax statement; poll the resource or listen for employee_tax_statement.updated webhooks as publishing completes.

post/employee_tax_statements/{id}/simulate/publish

Request

Path parameters

idstring required

ID of the employee tax statement

Response

200

idstring
employeestring
companystring
yearinteger
form'fed_w2' | 'fed_w2c' | 'vi_w2vi' | 'vi_w2vic'

Tax form type for this statement.

amendsunknown
amended_byunknown
documentunknown
filingsstring[]
filed_atunknown
refreshed_atstring date-time

When the statement's data was last refreshed, in UTC.

Example response

{
  "id": "ets_789",
  "employee": "emp_123",
  "company": "com_123",
  "year": 2025,
  "form": "fed_w2",
  "filings": [
    "com_fil_999"
  ],
  "refreshed_at": "2025-12-01T18:45:00Z"
}

Changes