Generate the Liability report

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.