# Update filing status for a company

Source: https://developer.avalara.com/products/returns/integration-guides/managed-returns/xrs0073580781163/

Guide: Avalara Managed Returns API (U.S. and Canada)

# Update filing status for a company

Learn how to update a company's filing status using a GraphQL mutation and understand the supported filing status values.

Update the filing status of a company so 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 is 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 isn’t 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.