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.

{
  "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 fpr 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