# GetReportById

Retrieves a report by its unique ID

`GET /reports/{reportId}/status`

**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/GetReportById/

## Description

Retrieves a specific report by its unique identifier. Returns complete report details including metadata, status, and associated information.

## 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"). |
| `reportId` |  | path | Yes | The unique ID for this report as returned in a GET /reports response. |

## Responses

| Status | Description | Schema |
|---|---|---|
| 200 | Report found and returned successfully. | `ReportItem` |
| 400 | Bad request. | `BadRequest` |
| 401 | Unauthorized. |  |
| 403 | Forbidden. | `ForbiddenError` |
| 404 | Report not found. | `NotFoundError` |

### 200 Response: `ReportItem`

Represents a single report with full details including metadata and associated transaction IDs.

| Property | Type | Required | Description |
|---|---|---|---|
| `reportId` | string | No | The unique ID for this report. Example: `bd82c787-c163-44f1-a784-c45a6c6ded61`. |
| `jobId` | string | No | The unique ID of the job that generated this report. Example: `db8914ce-fbf4-3d60-96d7-95a6464eec43`. |
| `reportGenerateDate` | string | No | The date and time when the report was generated. Example: `2026-03-02T12:40:14.529894Z`. |
| `reportFrom` | string | No | The start date of the reporting period. Example: `2026-02-01`. |
| `reportTo` | string | No | The end date of the reporting period. Example: `2026-02-28`. |
| `countryCode` | string | No | The two-letter ISO-3166 country code for which this report was generated. Example: `FR`. |
| `countryMandate` | string | No | The e-invoicing mandate for the specified country. Example: `FR-B2B-REPORTING`. |
| `documentType` | string | No | The type of document covered by this report. Example: `TAX_REPORT`. |
| `documentSubType` | string | No | The sub-type of the document. Example: `MONTHLY_SALES_TAX`. |
| `reportReference` | string | No | An internal reference path for the report. Example: `/document-exchange/pv/tr-consolidated-reports/fc63d180/output/fc63d180.xml`. |
| `reportName` | string | No | The name of the report file. Example: `FFE1025A_PPF070_PPF0702026000000000000002`. |
| `status` | string | No | The current status of the report. Possible values include: PENDING, PROCESSING, COMPLETED, FAILED, SENT_TO_PPF, ERROR. Example: `SENT_TO_PPF`. |
| `reportFormatMimetypes` | string | No | The MIME type of the report file. Example: `application/xml`. |
| `tenantId` | string | No | The tenant identifier associated with this report. Example: `64e46c39b55286c29d5b1693`. |
| `taName` | string | No | The name of the tax authority for this report. Example: `DGFiP`. |
| `taxInvoiceAmount` | number | No | The total invoice amount covered by this report. Example: `210`. |
| `totalTaxAmount` | number | No | The total tax amount covered by this report. Example: `0`. |
| `metadata` | object | No | Additional report metadata (free-form JSON). Contents vary by country mandate. |
| `transactionIds` | string[] | No | List of transaction IDs associated with this report. |

## Example Request

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