CHcheckhq

List employee tax statements

Changed on
get/employee_tax_statements

Request

Query parameters

employeestring

ID of the employee to get tax statements for

companystring

ID of the company to get tax statements for

yearnumber

Year to get tax statements for

form'fed_w2' | 'vi_w2vi'

Filter by base tax form type

publication_status'draft' | 'published' | 'pending_correction'

Filter by publication status

type'original' | 'amendment'

Filter by statement type

published_fromstring date-time

Return employee tax statements whose published_at is on or after the provided datetime (ISO-8601). Inclusive at the boundary.

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

  • 5a54f5eb888bRevision changes
    • info

      added the new optional query request parameter form

    • info

      added the new optional query request parameter publication_status

    • info

      added the new optional query request parameter published_from

    • info

      added the new optional query request parameter type

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status