---
updatedAt: 2026-06-23T15:49:30.000Z
agentTools:
  projectIndex: https://docs.checkhq.com/llms.txt
---

# The filing object

Use the filing object to show the state of a tax filing for a given period, including the status changes that have occurred in its lifecycle.

```json
{
  "id": "com_fil_9kL2mN8pQ4rS6tU1vW3x",
  "company": "com_7bF9dG2hJ5kM8nP1qR4s",
  "year": 2024,
  "period": "q1",
  "label": "Federal Quarterly Filing - Q1",
  "jurisdiction": "fed",
  "agency": "agc_ukjABgbD0hQ3dfBRyMPD",
  "due_at": "2024-04-15",
  "filed_at": "2024-04-12T16:30:25.847Z",
  "closed_at": "2024-04-08T00:00:00.000Z",
  "document": "doc_3aE6fH9iL2mO5pR8sV1y",
  "filing_attempts": 2,
  "amends": null,
  "amended_by": null,
  "status": "filed",
  "status_history": [
    {
      "status": "inapplicable",
      "status_at": "2024-01-15T10:30:15.423Z",
      "blocked_reasons": []
    },
    {
      "status": "pending",
      "status_at": "2024-01-20T14:45:32.156Z",
      "blocked_reasons": []
    },
    {
      "status": "blocked",
      "status_at": "2024-03-10T09:15:48.792Z",
      "blocked_reasons": [
        {
          "type": "applied_for_tax_id",
          "resource_type": "company_tax_param",
          "resource": "spa_h7zSw4NITCtef4Taf5yA",
          "note": null
        }
      ]
    },
    {
      "status": "pending",
      "status_at": "2024-03-12T11:20:07.234Z",
      "blocked_reasons": []
    },
    {
      "status": "submitted",
      "status_at": "2024-03-12T11:23:07.234Z",
      "blocked_reasons": []
    },
    {
      "status": "filed",
      "status_at": "2024-04-12T16:30:25.847Z",
      "blocked_reasons": []
    }
  ]
}
```

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        **field**
      </th>

      <th style={{ textAlign: "left" }}>
        **type**
      </th>

      <th style={{ textAlign: "left" }}>
        **description**
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        **`id`**
      </td>

      <td style={{ textAlign: "left" }}>
        ID
      </td>

      <td style={{ textAlign: "left" }}>
        ID of the `Filing` (prefixed with `com_fil_`)
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`company`**
      </td>

      <td style={{ textAlign: "left" }}>
        ID
      </td>

      <td style={{ textAlign: "left" }}>
        ID of the `Company`
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`year`**
      </td>

      <td style={{ textAlign: "left" }}>
        int
      </td>

      <td style={{ textAlign: "left" }}>
        Year in which the filing is for
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`period`**
      </td>

      <td style={{ textAlign: "left" }}>
        enum, one of `annual`, `q1`, `q2`, `q3`, `q4`, `january`, `february`, `march`, `april`, `may`, `june`, `july`, `august`, `september`, `october`, `november`, `december`
      </td>

      <td style={{ textAlign: "left" }}>
        Filing period in the `year`.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`period_start`**
      </td>

      <td style={{ textAlign: "left" }}>
        date
      </td>

      <td style={{ textAlign: "left" }}>
        Start date of the filing period
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`period_end`**
      </td>

      <td style={{ textAlign: "left" }}>
        date
      </td>

      <td style={{ textAlign: "left" }}>
        End date of the filing period
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`label`**
      </td>

      <td style={{ textAlign: "left" }}>
        string
      </td>

      <td style={{ textAlign: "left" }}>
        Human-readable label for the filing.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`jurisdiction`**
      </td>

      <td style={{ textAlign: "left" }}>
        * _nullable_* enum
      </td>

      <td style={{ textAlign: "left" }}>
        Lowercase region code for the filing (`fed` or lowercased [ISO 3166-2:US](https://en.wikipedia.org/wiki/ISO_3166-2:US) region code). Matches the `jurisdiction` values on [Agency](https://docs.checkhq.com/reference/the-agency-object) and [Tax](https://docs.checkhq.com/reference/the-tax-object) objects.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`agency`**
      </td>

      <td style={{ textAlign: "left" }}>
        * _nullable_* ID
      </td>

      <td style={{ textAlign: "left" }}>
        ID of the [Agency](https://docs.checkhq.com/reference/the-agency-object) that receives this filing.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`due_at`**
      </td>

      <td style={{ textAlign: "left" }}>
        date
      </td>

      <td style={{ textAlign: "left" }}>
        ISO8601 date the filing is due to the agency by.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`filed_at`**
      </td>

      <td style={{ textAlign: "left" }}>
        * _nullable_* datetime in UTC
      </td>

      <td style={{ textAlign: "left" }}>
        ISO8601 datetime the filing status became successfully `filed`.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`closed_at`**
      </td>

      <td style={{ textAlign: "left" }}>
        * _nullable_* datetime in UTC
      </td>

      <td style={{ textAlign: "left" }}>
        Timestamp when Check closed the filing period. Any company filing processed after this date will appear as a `delayed_filing` in the Usage API. Check closes a filing after processing all unblocked companies at least 8 days before the due date.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`document`**
      </td>

      <td style={{ textAlign: "left" }}>
        * _nullable_* ID
      </td>

      <td style={{ textAlign: "left" }}>
        If the `processing_status` is `filed`, the ID of the `CompanyTaxDocument`.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`filing_attempts`**
      </td>

      <td style={{ textAlign: "left" }}>
        int, default 0
      </td>

      <td style={{ textAlign: "left" }}>
        Number of filing attempts made by Check.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`amends`**
      </td>

      <td style={{ textAlign: "left" }}>
        * _nullable_* list of IDs
      </td>

      <td style={{ textAlign: "left" }}>
        List of original Filing IDs that this resource is an amendment of. If populated, indicator of this Filing being an amendment.  
        Will contain only one ID for now, but may be contain multiple IDs in the future.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`amended_by`**
      </td>

      <td style={{ textAlign: "left" }}>
        * _nullable_* list of IDs
      </td>

      <td style={{ textAlign: "left" }}>
        List of Filing IDs that amend this filing.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`status`**
      </td>

      <td style={{ textAlign: "left" }}>
        enum, one of `pending`, `blocked`, `submitted`, `filed` , or`inapplicable`
      </td>

      <td style={{ textAlign: "left" }}>
        The current filing processing status.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        **`status_history`**
      </td>

      <td style={{ textAlign: "left" }}>
        list of `StatusHistory` objects
      </td>

      <td style={{ textAlign: "left" }}>
        List of the most recent status changes, in reverse chronological order. Limited to most recent 50. Each object represents a processing status change.
      </td>
    </tr>
  </tbody>
</Table>

**`StatusHistory`**

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Attribute
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `status`  
        _enum_
      </td>

      <td>
        One of `pending`, `blocked`, `submitted`, `filed` , `inapplicable`
      </td>
    </tr>

    <tr>
      <td>
        `status_at`  
        _datetime in UTC_
      </td>

      <td>
        When the previous status was changed to `status`.
      </td>
    </tr>

    <tr>
      <td>
        `blocked_reasons`  
        _nullable list of `BlockedReason` objects_
      </td>

      <td>
        Optional list of reason enumerations for the status change to `blocked`.
      </td>
    </tr>
  </tbody>
</Table>

**`BlockedReason`**

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Attribute
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `type`  
        _enum_
      </td>

      <td>
        Options enumerated below.
      </td>
    </tr>

    <tr>
      <td>
        `resource_type`  
        _nullable enum_
      </td>

      <td>
        One of [CompanyTaxParam](https://docs.checkhq.com/reference/get-company-tax-parameter-setting), [Requirement](https://docs.checkhq.com/reference/the-requirement-object), [payroll](https://docs.checkhq.com/update/reference/payrolls-1), [payment](https://docs.checkhq.com/update/reference/payments-2), or [employee](https://docs.checkhq.com/update/reference/employees-1).
      </td>
    </tr>

    <tr>
      <td>
        `resource`  
        _nullable ID_
      </td>

      <td>
        ID of the resource for resolving the blocker
      </td>
    </tr>

    <tr>
      <td>
        `note`  
        _nullable string_
      </td>

      <td>
        Note provided by Check operators that provides more context on the blocker reason, when available. For example, "John Smith's SSN is all 0s."
      </td>
    </tr>
  </tbody>
</Table>

**Possible BlockedReason types**

The complete, canonical list of `type` values — each with its description, employer-facing guidance, associated `resource_type`, and resolution path — is maintained in the [Filing blockers](https://docs.checkhq.com/docs/tax-filings#filing-blockers) section of the Tax Filings guide.

**`status`lifecycle:**

![](https://files.readme.io/b0c35df1e8618bed9ff44b5f8611cbc53e4445b49d4d476483248613d13c3d7a-image.png)

<br />