> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Analytics Reporting Warehouse
> Analytics Reporting Warehouse in ABBYY Vantage: track field changes, manual verification effort, and document accuracy metrics for Process skills.
The Analytics Reporting Warehouse stores data that can be used to analyze the efficiency of document processing within the system. With this data, you can identify which documents require more time for manual verification and why.
Statistics are collected for Process skills that have at least one Manual Review step and include at least one Document skill. The system compares the document's initial pre-manual review state with its state after processing.
The Analytics Reporting Warehouse is one of Vantage's two reporting warehouses. For an overview of both — and the [Business Processing Reporting](/vantage/developer/reporting/business-reporting) warehouse for transaction-level data — see [Reporting service](/vantage/developer/reporting/reporting-service).
The Analytics Reporting Warehouse stores the following data:
* Information about changes in documents
* Information about document fields:
* The number of extracted field values
* The number of changed field values
* The status of each field (indicating whether it is correct, has recognition issues, has been located incorrectly, or has not been detected)
## Migrating from v1 to v2
Only the path has changed from "/v1/" to "/v2/." There are no request/response field or behavioral changes.
## Downloading a data report
Only users with **Tenant Administrator** or **Processing Supervisor** roles can download data reports. For more information, see [Role-based access control](/vantage/documentation/tenant-admin/tenant-management/role-based-access).
To obtain data from the Analytics Reporting Warehouse, send a **GET** request to one of the following resources, depending on the kind of report you need to obtain:
### Obtaining data about documents processed by a Process skill
```text US theme={null}
GET https://vantage-us.abbyy.com/api/reporting/v2/qa/process-skills/documents
```
```text EU theme={null}
GET https://vantage-eu.abbyy.com/api/reporting/v2/qa/process-skills/documents
```
```text AU theme={null}
GET https://vantage-au.abbyy.com/api/reporting/v2/qa/process-skills/documents
```
### Obtaining data about fields processed by Process and Document skills
```text US theme={null}
GET https://vantage-us.abbyy.com/api/reporting/v2/qa/process-skills/fields
```
```text EU theme={null}
GET https://vantage-eu.abbyy.com/api/reporting/v2/qa/process-skills/fields
```
```text AU theme={null}
GET https://vantage-au.abbyy.com/api/reporting/v2/qa/process-skills/fields
```
The request accepts the following parameters:
* **startDate**. The first day of the period for which data should be downloaded (sample formatting: 2022-01-07T13:03:38, time should be in UTC). This is a required parameter.
* **endDate**. The last day of the period for which data should be downloaded (sample formatting: 2022-09-07T13:03:38, time should be in UTC).
* **processSkillId**. The ID of the Process skill the data for which should be downloaded. Required for the `/api/reporting/v2/qa/process-skills/fields` request; optional for the `/api/reporting/v2/qa/process-skills/documents` request.
* **documentSkillId**. The ID of the Document skill for which the data should be downloaded.
You can include this parameter only in the `/api/reporting/v2/qa/process-skills/fields` request.
* **imageType**. The type of document image. Possible values: Unknown, Receipt, A4, BusinessCard, Book, Id, PassportRus, DiscountCard, BankCard, NotDocument, PassportPage.
* **imageColority**. Indicates whether the document's first page is color, black, or black and white. Possible values: BlackWhite, Gray, Color.
* **imageSource**. The source of the document image. Possible values: Unknown, Photo, Scan, Synthetic, Screenshot, Pdf.
* **wasCorrectedInManualReview**. Indicates whether the document fields were corrected during manual review.
* **wasDocumentTypeChangedInManualReview**. Indicates whether the document type was changed during manual review.
The resulting CSV file will contain the following information sorted into columns.
### Report about changes in documents
| Column | Description |
| :------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ProcessSkillId` | The ID of the Process skill. |
| `ProcessSkillVersion` | The version of the Process skill. |
| `ProcessSkillName` | The name of the Process skill. |
| `DocumentSkillId` | The ID of the Document skill. |
| `DocumentSkillVersion` | The version of the Document skill. |
| `DocumentSkillName` | The name of the Document skill. |
| `TransactionId` | The ID of the transaction. |
| `HasManualReview` | Indicates whether the document was manually reviewed. Possible values: 1 or 0. |
| `DocumentId` | The ID of the document passed for processing. |
| `DocumentName` | The name of the document passed for processing. |
| `PageSize` | The size of the document's first page in pixels (width and height). |
| `ImageColority` | Indicates whether the document's first page is color, gray, or black and white. |
| `ImageSource` | The image source of the document's first page. For example: scan, photo, PDF file, screenshot, etc. |
| `ImageType` | The image type of the document's first page. For example: A4, receipt, bank card, etc. |
| `DPI` | The number of dots (or pixels) in the document's first page. |
| `TransactionParameter1..N` | Transaction parameters passed for processing. If the document does not contain any transaction parameters, the value in the report will be null. |
| `DimensionField1..MValue` | Dimension fields passed for processing. If the document does not contain any dimension fields, the value in the report will be null. |
| `DocumentSkillChanged` | Indicates whether the document type was changed during manual review. Possible values: true, false. |
| `DocumentSkillIdUsedBeforeManualReview` | The Document skill applied to the document before the Manual Review stage. |
| `DocumentSkillVersionUsedBeforeManualReview` | The version of the Document skill applied to the document before the Manual Review stage. |
| `DocumentSkillNameUsedBeforeManualReview` | The name of the Document skill applied to the document before the Manual Review stage. |
| `NumberOfExportedFields` | The number of exported fields in the document. |
| `NumberOfChangedFields` | The number of manually changed fields in the document. |
| `TransactionCompletedUtc` | The completion time of the transaction (UTC). |
| `App` | The application that created the transactions in the report (for example: PublicAPI). This column appears only when the matched transactions carry the `App` parameter. |
Data for this report will be stored for 12 months.
### Report about changes in fields
| Column | Description |
| :------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ProcessSkillId` | The ID of the Process skill. |
| `ProcessSkillVersion` | The version of the Process skill. |
| `ProcessSkillName` | The name of the Process skill. |
| `DocumentSkillId` | The ID of the Document skill. |
| `DocumentSkillVersion` | The version of the Document skill. |
| `DocumentSkillName` | The name of the Document skill. |
| `TransactionId` | The ID of the transaction. |
| `HasManualReview` | Indicates whether the document was manually reviewed. Possible values: 1 or 0. |
| `DocumentId` | The ID of the document passed for processing. |
| `DocumentName` | The name of the document passed for processing. |
| `PageSize` | The size of the document's first page in pixels (width and height). |
| `ImageColority` | Indicates whether the document's first page is color, gray, or black and white. |
| `ImageSource` | The image source of the document's first page. For example: scan, photo, PDF file, screenshot, etc. |
| `ImageType` | The image type of the document's first page. For example: A4, receipt, bank card, etc. |
| `DPI` | The number of dots (or pixels) in the document's first page. |
| `TransactionParameter1..N` | Transaction parameters passed for processing. If the document does not contain any transaction parameters, the value in the report will be null. |
| `DimensionField1..MValue` | Dimension fields passed for processing. If the document does not contain any dimension fields, the value in the report will be null. |
| `NumberOfExportedFields` | The number of exported fields in the document. |
| `NumberOfChangedFields` | The number of manually changed fields in the document. |
| `FieldID` | The ID of the document field. |
| `FieldName` | The name of the document field. |
| `Correct` | Information about the correction status of non-repeating fields and the number of instances of repeating fields that weren't corrected. Possible values:
- 1, if the non-repeating field wasn't corrected during manual review.
- The number of instances of a repeating field that weren't corrected during manual review. |
| `RecognitionIssue` | Information about recognition issues during the processing of document fields. Possible values:
- 1, if the non-repeating field's value was corrected, but the region was not.
- The number of instances where the values of a repeating field were corrected during manual review. |
| `DetectedIncorrectly` | Information about corrections that were made during the manual review. Possible values:
- 1, if the region and value of a non-repeating field were corrected.
- The number of instances where regions and values of a repeating field were corrected during manual review. |
| `NotDetected` | Information about field values that were not extracted before manual review. Possible values:
- 1, if the value of a non-repeating field wasn't extracted before manual review and was created by a verifier.
- The number of instances of a repeating field's values that were created during manual review. |
| `IsInDocument` | Indicates if the field has at least one instance in the document. Possible values: true, false. |
| `TransactionCompletedUtc` | The completion time of the transaction (UTC). |
| `App` | The application that created the transactions in the report (for example: PublicAPI). This column appears only when the matched transactions carry the `App` parameter. |
Data for this report will be stored for 14 days.
Data obtained in CSV format may be further analyzed in any BI tool.