# GetReports

Returns a list of reports

`GET /reports`

**API:** Avalara E-Invoicing API
**Tag:** Reports
**API Version:** 1.6
**Base URL:** https://api.sbx.avalara.com/einvoicing
**Authentication:** Bearer token

Source: https://developer.avalara.com/products/e-invoicing/api/v1.6/methods/Reports/GetReports/

## Description

Retrieves all reports with optional filtering, paging, and sorting. Results are filtered by tenant. Supports OData-style filtering using the $filter parameter. Use $top and $skip for paging; when more results exist, the response includes @nextLink to fetch the next page. Default sort order is by report generation date (descending).

## Parameters

| Name | Type | In | Required | Description |
|---|---|---|---|---|
| `avalara-version` | string | header | Yes | Header that specifies the API version to use (for example "1.6"). |
| `X-Avalara-Client` | string | header | No | Optional header for a client identifier string used for diagnostics (for example "Fingerprint"). |
| `X-Correlation-ID` | string | header | No | Optional correlation identifier provided by the caller to trace the call (for example "f3f0d19a-01a1-4748-8a58-f000d0424f43"). |
| `$filter` | string | query | No | OData-style filter expression. Supports operators: eq, ne, gt, ge, lt, le, like, ilike, contains. Examples: status eq 'COMPLETED', reportGenerateDate gt '2025-11-01', transactionIds contains 'TXN-2025-001' |
| `undefined` |  |  | No |  |
| `undefined` |  |  | No |  |
| `$count` | string | query | No | When set to true, the response body also includes the count of items in the collection. |
| `$countOnly` | string | query | No | When set to true, the response returns only the count of items in the collection. |
| `$orderby` | string | query | No | OData-style orderby expression. Format: 'field asc' or 'field desc'. Default: reportGenerateDate desc |

## Responses

| Status | Description | Schema |
|---|---|---|
| 200 | Reports retrieved successfully. | `ReportListResponse` |
| 400 | Bad request. | `BadRequest` |
| 401 | Unauthorized. |  |
| 403 | Forbidden. | `ForbiddenError` |

### 200 Response: `ReportListResponse`

Returns the requested list of reports matching the query parameters.

| Property | Type | Required | Description |
|---|---|---|---|
| `@recordsetCount` | string | No | Count of reports matching the filter for the given query. Present when the request includes $count=true. Example: `1`. |
| `@nextLink` | string | No | URL to retrieve the next page of results when more items match the query. Omitted or null when there is no next page. |
| `value` | ReportItem[] | **Yes** | Array of reports matching the query parameters. |

## Example Request

```bash
curl -X GET "https://api.sbx.avalara.com/einvoicing/reports" \
  -H "Authorization: Basic <credentials>" \
  -H "Accept: application/json"
```