# Approve filings

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

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

# Approve filings

Learn how to approve filings manually or automatically to ensure timely submission.

Once a return has been generated and reconciled, it must be approved before Avalara can file it on behalf of the merchant. The merchant completes this step manually through your platform. Else, Avalara completes it automatically by a set deadline.

## Client review and approval window

Between the **1st** and **10th** of each month, clients have the opportunity to:

-   **Review** their prepared returns.

-   **Approve** returns for filing.

This manual review is optional but recommended to make sure accuracy before submission.

Note

Partners who build integrations should make sure that clients can see this window. This is important, especially when clients plan to approve filings manually.

## Automatic approval

Avalara will automatically approve all unapproved returns at 5:00 p.m. PT on the 10th of each month to ensure that you file returns on time.

This automation guarantees timely submission even if the client doesn't review or take manual action.

## Developer implementation guidance

Partner software developers must understand the following:

-   The filing timeline drives this process. Once a filing calendar is created and approved for the respective region and period, Avalara generates returns that are eligible for approval.

-   Avalara uses the `approveFilings` mutation to capture return approvals (see below).

-   The partner, acting on behalf of the Firm, triggers this step programmatically.

**View request**:

```
mutation ApproveFilings {
  approveFilings(
    input: {
      companyId: 12345678
      month: 3
      year: 2025
      country: "US"
      region: "TX"
      approvalInput: { approve: true }
    }
  ) {
    value {
      companyId
      filingRegions {
        approveDate
        collectAmount
        filingId
        status
        startDate
        salesAmount
        region
        nonTaxableAmount
        id
        hasNexus
        taxAmount
      }
      id
      month
      type
      year
    }
  }
}
```

**View response**:

```
{
  "data": {
    "approveFilings": {
      "value": [
        {
          "companyId": 123456,
          "filingRegions": [
            {
              "approveDate": "2025-04-24T09:30:27.056868",
              "collectAmount": 0,
              "filingId": 123456,
              "status": "PREPARINGTOFILE",
              "startDate": "2025-03-01T00:00:00",
              "salesAmount": 20.2558,
              "region": "TX",
              "nonTaxableAmount": 0,
              "id": 1416389,
              "hasNexus": false,
              "taxAmount": 1.67
            }
          ],
          "id": 123456,
          "month": 3,
          "type": "ORIGINAL",
          "year": 2025
        }
      ]
    }
  }
}
```