The Check API Developer Hub

Welcome to the Check API developer hub. You'll find comprehensive guides and documentation to help you start working with Check API as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    
added

Employee tax documents

8 months ago 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