# Approve extracted filing requests

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

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

# Approve extracted filing requests

Approve extracted pending filing requests and convert them into active filing calendars by using the `approveFilingRequests` GraphQL mutation.

The `approveFilingRequests` mutation approves 1 or more pending filing requests that the background return extraction process created. Each approved filing request becomes an active recurring filing calendar.

Approval is permanent. Before you call this mutation, review pending filing requests by using the `filingCalendarRequests` query. If needed, update configuration answers by using the `updateFilingCalendarRequest` mutation. Approve only the filing requests that you intend to file.

**Key considerations**

-   **Preapproval review**: Use `filingCalendarRequests` to verify effective dates, filing frequencies, and registration answers before approval.

-   **Error reporting**: If a filing request can't be approved, the issue appears in the `errorCount` and `errorMessages` fields, not as a top-level GraphQL error. Check both fields before you confirm approval in your UI.

## View request

```
mutation ApproveFilingRequests($input: ApproveFilingRequestsInput!) {
  approveFilingRequests(input: $input) {
    isSuccess
    approvedCount
    errorCount
    errorMessages
  }
}
```

**Input variables**:

```
{
  "input": {
    "companyId": "1234567",
    "filingRequestIds": ["200001"]
  }
}
```

Table 1. Input variable details

Argument

Type

Description

`companyId`

`ID!`

The company that owns the filing requests.

`filingRequestIds`

`[ID!]!`

The filing requests to approve, from `filingRequestIds` on `taskStatus`.

## View response

```
{
  "data": {
    "approveFilingRequests": {
      "isSuccess": true,
      "approvedCount": 1,
      "errorCount": 0,
      "errorMessages": []
    }
  }
}
```

**Response field descriptions**:

Response field

Description

`isSuccess`

Indicates whether the approval succeeded overall.

`approvedCount`

The number of filing requests approved.

`errorCount`

The number of filing requests that couldn't be approved.

`errorMessages`

A message for each filing request that couldn't be approved.

## Next step

After filing requests are approved and converted to active filing calendars, complete these common follow-up steps:

1.  [Sign funding power of attorney (FPOA)](/managed-returns/noe0861719748448/ "Learn about the funding power of attorney (FPOA) and how to sign and track its status.").
2.  [Submit for compliance review](/managed-returns/tpx8691109439671/ "Learn how to submit a company for Avalara's compliance review after completing onboarding.")