August 5, 2020
May 12, 2022

Employee tax documents

by 
Cameron Spickert
August 5, 2020
May 12, 2022

Employee tax documents

by 
Cameron Spickert

Last month we added the ability to access company tax documents, and today we're launching a new API endpoint for employee tax documents, making it easy to access federal and state withholding forms submitted by employees, as well as copies of employee wage and tax statements filed by Check, such as the federal W-2 form.

To retrieve a list of employee tax documents, make a GET request to /documents/employee_tax_documents. This endpoint can also be filtered by year, company, and/or a specific employee.

Documents may be downloaded by making a GET request to /documents/employee_tax_documents/<document_id>/download.

The following is an example request to list all documents for the employee emp_RMXCmfSQ0UrtfvShSyCk:


{
    "next": null,
    "previous": null,
    "results": [
        {
            "id": "doc_d0S5zFEp1YKuu90xytgq",
            "employee": "emp_RMXCmfSQ0UrtfvShSyCk",
            "category": "employee_tax_document",
            "label": "Federal W-4",
            "jurisdiction": "FED",
            "year": 2020,
            "filed_on": "2020-08-06"
        },
        {
            "id": "doc_AH0IlLyoeZk3THYFAMaW",
            "employee": "emp_RMXCmfSQ0UrtfvShSyCk",
            "category": "employee_tax_document",
            "label": "New Jersey NJ-W4",
            "jurisdiction": "NJ",
            "year": 2020,
            "filed_on": "2020-08-06"
        }
    ]
}

Each result in the list response includes the following information about a document:

  • employee - the employee that this document was filed for
  • category - the category of the document
  • label - the type of the document
  • jurisdiction - jurisdiction to which this document applies
  • year - the year this document was filed
  • filed_on - the date this document was filed on

More from the Check blog

June 22, 2022
June 22, 2022

Voices of Check: Engineering Manager, Lindsey Martin

Lindsey Martin shares her experience as an Engineering Manager at Check, balancing work and life as a mother, and her path forward.
June 13, 2022
June 13, 2022

Piece Rate Pay unlocks payroll for agriculture, manufacturing, and more

Millions of people are paid every day in units other than time. That’s why we’re excited to offer Piece Rate Pay on the Check platform.
May 24, 2022
May 12, 2022

Next Day Pay, the fastest payroll processing period in embedded payroll

At Check, we want to make paying people simple – even in the case of a missed deadline. That’s why we’re excited to announce Next Day Pay, the fastest payroll processing speed available in embedded payroll.