See the Employee Tax Statements and Tax Packages guide for more details on how to use this API
The EmployeeTaxStatement Object
Fields non-nullable unless specified.
| field | type | description |
|---|---|---|
id | ID | ID of the EmployeeTaxStatement |
employee | ID | ID of the Employee |
company | ID | ID of the Company |
year | int | Year in which the filing is for |
amends | nullable ID | ID of the previous EmployeeTaxStatement that this resource amends. If populated, indicator of this Filing being an amendment. |
amended_by | nullable ID | ID of the next EmployeeTaxStatement that amends this employee data. |
document | nullable ID | If filed, the ID of the EmployeeDocument. |
filings | list of IDs | List of IDs that are the company Filings in which this worker data has been submitted |
filed_at | nullable datetime in UTC | ISO8601 datetime when all related filings became successfully filed. |
When document is null, that means the document is not yet generated. You can generate the document by sending a post request to /tax_packages with the employees for which you want to generate a document.
GET /employee_tax_statements/?employee=emp_123
List W-2 and W-2Cs for a single employee.
[
{
"id": "ets_789",
"employee": "emp_123",
"company": "com_123",
"year": 2025,
"amends": null,
"amended_by": null,
"document": null,
"filings": ["com_fil_999"],
"filed_at": null
},
{
"id": "ets_456",
"employee": "emp_123",
"company": "com_123",
"year": 2024,
"amends": "ets_123",
"amended_by": null,
"document": "doc_456",
"filings": ["com_fil_789", "com_fil_888"],
"filed_at": "2025-02-10T15:30:00Z"
},
{
"id": "ets_123",
"employee": "emp_123",
"company": "com_123",
"year": 2024,
"amends": null,
"amended_by": "ets_456",
"document": "doc_123",
"filings": ["com_fil_123", "com_fil_234"],
"filed_at": "2025-02-10T15:30:00Z"
}
]