# Generate the Liability report

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

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

# Generate the Liability report

Learn about the Liability Summary and Detail reports, their categories, and how to generate them using GraphQL.

As part of the reconciliation process, Avalara provides 2 key reports to help partners (acting as the Firm) and merchants understand and validate their tax obligations before filing returns.

**Types of reports:**

-   **Liability Summary Report**: Provides a high-level breakdown of total tax liability by jurisdiction.

-   **Liability Detail Report**: Provides a return or form-level breakdown of liability, helping partners trace each line item to the associated return.

**Liability categories:**

Both reports include:

-   **Assigned liabilities**: Transactions that are scheduled to be reported on an active return via a configured filing calendar.

-   **Unassigned liabilities**: Transactions that aren’t yet associated with a filing calendar and therefore won’t be included in a return. Common reasons include:

    -   Filing calendar not yet configured for a region.

    -   Errors in imported data (for example, a missing region code).

## How to generate the reports

Partners can generate these reports using the following GraphQL query:

**View request**:

```
query LiabilityReports {
  liabilityReports(companyId: 123456, liabilityType: ALL, month: 3, year: 2025) {
    errors {
      message
      extensions {
        code
        documentation
        requestId
        status
      }
    }
    value {
      reports
    }
  }
}
```

**View response**:

```
{
  "data": {
    "liabilityReports": {
      "errors": [],
      "value": {
        "reports": [
          80,
          75,
          3,
          4,
          20,
          0,
          8,
          0,
          8,
          0,
          37,
          112,
          150,
          90]
      }
    }
  }
}
```

## Response format

The response includes a `reports` field, returned as a **byte array**. The partner needs to convert the byte array into a ZIP file, which contains both summary and detailed liability reports. These can then be transformed into the desired reporting format (for example, CSV, JSON, UI visualization).

Note

Avalara doesn't provide a downloadable report format. Partners are expected to consume the raw byte array and convert it for merchant use.