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 |