🚧
Note: this API is slated for deprecation by 12/31/2025, and will be replaced by the Filings API. Reach out to Check to learn more.
As of Q3 filing (October), the Tax Filing API will no longer have up-to-date data and Q3 failed filings will not be available here. The API will continue to function through the end of December, but only containing data through Q2.

Use the tax filing object to show the state of a tax filing for a given period, including the events that have occurred in its lifecycle.

NOTE: The initial version of this API will only contain failed filings. In future versions, this API will include all filings across the entire filing lifecycle, regardless of whether or not they've failed.

{
  "id": "flg_GaeJoEAzbqqc2D9GMfOF",
  "company": "com_vIFHhvyGN47ej1upyIT8",
  "year": 2023,
  "description": "Michigan State Unemployment Tax",  
  "frequency": "quarterly",
  "period": "q2",
  "status": "filed",
  "can_retry": false,
  "tax_filing_events": [
    {
      "id": "fev_jIFHhvyGN47ej1upyIT8",
      "tax_filing": "flg_jIFHhvyGN47ej1upyIT8",
      "status": "filed",
      "created_at": "2023-04-12T21:32:44.957364Z",
      "category": null,
      "label": null,
      "account_number": "123456789",
    },
    {
      "id": "fev_jupyIT8upyIT8upyIT87",
      "tax_filing": "flg_jIFHhvyGN47ej1upyIT8",
      "status": "submitted",
      "created_at": "2023-04-12T21:32:44.957364Z",
      "category": null,
      "label": null,
      "account_number": "123456789",
    },
    {
      "id": "fev_jHhvyHhvyHhvyHhvyHhv",
      "tax_filing": "flg_jIFHhvyGN47ej1upyIT8",
      "status": "pending",
      "created_at": "2023-04-12T21:32:44.957364Z",
      "category": null,
      "label": null,
      "account_number": "123456789",
    },
    {
      "id": "fev_7ej1upy7ej1upy7ej1up",
      "tax_filing": "flg_jIFHhvyGN47ej1upyIT8",
      "status": "rejected",
      "created_at": "2023-04-12T21:32:44.957364Z",
      "category": "applied_for_invalid_ein",
      "label": "EIN is either invalid or Applied For. Return will not be accepted by the agency. If filed, the agency will reject the return",
      "account_number": "Applied For",
    },
    {
      "id": "fev_pyITpyITpyITpyITpyIT",
      "tax_filing": "flg_jIFHhvyGN47ej1upyIT8",
      "status": "submitted",
      "created_at": "2023-04-12T21:32:44.957364Z",
      "category": null,
      "label": null,
      "account_number": "Applied For",
    },
    {
      "id": "fev_GN47eGN47eGN47eGN47e",
      "tax_filing": "flg_jIFHhvyGN47ej1upyIT8",
      "status": "pending",
      "created_at": "2023-04-12T21:32:44.957364Z",
      "category": null,
      "label": null,
      "account_number": "Applied For",
    },
  ],
}

Attribute	Description
id string	Unique identifier for the tax filing.
company string	Unique identifier for the company.
frequency string	Cadency at which the tax filing is filed. One of: `annual`, `quarterly` and `monthly`.
period string	Filing period for the tax filing. One of: `annual`, `q1`, `q2`,`q3`, `q4`, `january`, `february`, `march`, `april`, `may`, `june`, `july`, `august` , `september`, `october` , `november`, or `december`.
status string	Status of the tax filing within its lifecycle. One of `pending`, `submitted`, `filed`, `rejected`, or `amendment_required`. See Tax Filing Status.
can_retry boolean	Flag indicating if the employer can update their tax inputs and request Check to refile the return. Is `True` only when `status` is `rejected`.
tax_filing_events list	Events that occurred throughout the tax filing lifecycle. Ordered by `created_at` datetime desc (most recent to least recent). See Tax Filing Event object.

Tax Filing Lifecycle