The tax filing event object

The tax filing event object represents a transition in the status of a tax filing. When displayed together, tax filing events display an immutable event log that represent the lifecycle of a specific tax filing.

{
  "id": "fev_jIFHhvyGN47ej1upyIT8",
  "tax_filing": "flg_jIFHhvyGN47ej1upyIT8",
  "status": "filed",
  "created_at": "2023-04-12T21:32:44.957364Z",
  "category": null,
  "label": null,
  "account_number": "123456789",
}

Attribute	Description
id string	Unique identifier for the tax filing event
tax_filing string	Unique identifier for the related tax filing.
status string	Status of the tax filing in its lifecycle. One of `pending`, `submitted`, `filed`, `rejected`, or `amendment_required`. See Tax Filing Status.
created_at string	Datetime string (UTC, timezone aware) indicating when the tax filing event was created.
category string	Machine-readable category explaining the status. Populated when the status is `rejected`, otherwise returns `null`. The `category` field currently only supports errors that occur for a failed filing. Will be one of `applied_for_invalid_ein`, `poa_tpa_failure`, `partial_failure_invalid_ssn`, `already_filed`, `not_liable`, `corrected_and_refiled_timely`, `inactive_account`, `missing_prior_quarter`, `missing_historical_data`, or `invalid_tax_rate`.
label string	Human-readable description of the `category` property as provided by the tax agency. Populated when the status is `rejected`, otherwise returns `null`. Currently supports errors that occur for a failed filing.
account_number string	Company's tax ID submitted on the tax return that identifies the company to the tax agency