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