Update filing status for a company

Update the filing status of a company to ensure that its filing status accurately reflects its current state. This topic also describes all supported filing status values and their descriptions. The status indicates whether the company is actively filing, inactive, or in another compliance-related state.

To update the filing status for a company, use the updateFilingStatus mutation.

View request

mutation updateFilingStatus {
  updateCompany(
    id: 11111
    input: {
      id: 11111
      name: "CRR Onboarding Test 44"
      status: INACTIVE
    }
  ) {
    isActive
    taxpayerIdNumber
    name
    isDeleted
    filingStatus
  }
}

View response

{
  "data": {
    "updateCompany": {
      "isActive": true,
      "taxpayerIdNumber": "00-0000001",
      "name": "CRR Onboarding Test 44",
      "isDeleted": false,
      "filingStatus": "INACTIVE"
    }
  }
}

Filing status values

The table below lists all supported filing status values and their descriptions.


Status	Description
NOTCONFIGUREDFORCOMPLIANCE	Indicates that the company isn’t set up for compliance.
NOTYETFILING	Indicates that the company hasn’t yet started filing.
FILINGREQUESTED	Indicates that a filing has been requested.
FIRSTFILING	Indicates that the company is in its first filing period.
ACTIVE	Indicates that the company is actively filing.
NOREPORTING	Indicates that the company doesn’t require reporting.
INACTIVE	Indicates that the company is not filing.

Result

After updating the filing status:

The company’s compliance behavior is updated in the system.
Filing workflows respect the new status.
The status change is immediately reflected in the company record.