The tax filing object

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