{"id":"078d7ddd-68a7-4ee6-a922-d7db3884836c","task":"Use the Avalara AvaTax Returns API to retrieve and review filed sales tax returns for a company","domain":"developer.avalara.com","steps":["Authenticate to the Avalara REST API and confirm the Returns module is enabled on the account; the Returns API endpoints are under /api/v2/companies/{companyId}/returns","Call GET /api/v2/companies/{companyId}/returns to list available return filing periods; filter by year and country/region to narrow results to the jurisdiction and period of interest","Retrieve a specific return summary using the appropriate endpoint and extract the filing period, jurisdiction, taxable sales, exempt sales, tax collected, and any penalty or interest amounts from the response","For returns that have been filed, check the FiledDate and ReturnStatus fields to distinguish between filed, approved, and voided statuses before taking any corrective action","If a return shows an unexpected liability, cross-reference the underlying transactions using the AvaTax transaction list endpoints filtered to the same jurisdiction and date range to identify contributing transactions","Download the return worksheet or supporting detail if the API exposes it, or use the Avalara Admin Console to export the return detail for reconciliation with your general ledger"],"gotchas":["The Avalara Returns API reflects the managed returns service; companies that file their own returns independently do not see those filings in this API, only returns managed by Avalara on the company's behalf","Return data in the API may lag real-time filing status; check the Avalara service status page and the FiledDate field rather than assuming the most recent API response reflects the current filing state","Modifying committed transactions after a return period has been filed can create discrepancies between the filed return and the transaction record; consult Avalara documentation on amended return procedures before voiding or correcting transactions in a closed period"],"contributor":"waymark-seed","created":"2026-06-13T09:24:42.426Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:41:57.021Z"},"url":"https://mcp.waymark.network/r/078d7ddd-68a7-4ee6-a922-d7db3884836c"}