---
title: "Fraud reporting"
canonical: https://documentation.maventa.com/integration-guide/invoice-receiving/fraud-reporting/
---

Maventa's fraud reporting feature lets end users flag received invoices they suspect to be fraudulent. By adding a “Report fraud” button to your integration, you give users a simple way to report suspicious invoices as part of their normal workflow.

Fraud reporting is a crowd-sourced warning service available through the **AutoXChange API**. When multiple receivers report the same sender, that sender may be added to a warning list. Invoices from listed senders can then trigger alerts through the [Detect](https://documentation.maventa.com/integration-guide/invoice-receiving/detect/) service.

> [!WARNING]
> Fraud reporting cannot be used to dispute an invoice or refuse payment. Reports are not automatically forwarded to the invoice sender or the authorities.

## How it works

- Each report is linked to a specific received invoice
- The user selects one or more reason categories and provides a contact email
- The user can optionally describe the suspected fraud in more detail
- All UI texts and translations are available via the API
- Only one report per invoice is allowed

## Submitting a report — example flow

Add a button or similar action in your system that lets users report a received invoice as suspected fraud.

![Report button](https://documentation.maventa.com/assets/pages/01-integration-guide/02-invoice-receiving/04-fraud-reporting/fraud_reporting_button.png)

### Step 1: Show information text

Display an informational text explaining the purpose and limitations of fraud reporting.

Fetch the text and translations using [GET /v1/invoices/reports/definitions](https://swagger.maventa.com/?urls.primaryName=STAGE%20-%20AutoXChange%20API#/invoices/getV1InvoicesReportsDefinitions). Available languages: EN, FI, SE, NO, DK, NL.

![Fraud report information text](https://documentation.maventa.com/assets/pages/01-integration-guide/02-invoice-receiving/04-fraud-reporting/fraud_reporting_information_text.png)

### Step 2: Select reason categories

The user selects one or more reasons for their report from predefined categories. At least one reason must be selected.

Fetch the categories and their descriptions using the same [GET /v1/invoices/reports/definitions](https://swagger.maventa.com/?urls.primaryName=STAGE%20-%20AutoXChange%20API#/invoices/getV1InvoicesReportsDefinitions) endpoint. Texts are available in EN, FI, SE, NO, DK, NL.

![Fraud report categories](https://documentation.maventa.com/assets/pages/01-integration-guide/02-invoice-receiving/04-fraud-reporting/fraud_reporting_categories.png)

### Step 3: Review and submit

The user reviews a summary of the report, provides a contact email, and optionally adds a description.

Submit the report using [POST /v1/invoices/{id}/reports](https://swagger.maventa.com/?urls.primaryName=STAGE%20-%20AutoXChange%20API#/invoices/postV1InvoicesIdReports).

Parameters:

- **`id`** (required) — Maventa invoice ID (path parameter)
- **`reason`** (required) — one or more reason categories
- **`email`** (required) — contact email for potential follow-up (not displayed to others)
- **`description`** (optional) — free-text description of the suspected fraud

![Fraud report summary](https://documentation.maventa.com/assets/pages/01-integration-guide/02-invoice-receiving/04-fraud-reporting/fraud_reporting_summary.png)

> [!NOTE]
> The reporting process does not need to follow a step-by-step flow. You can present all fields on a single screen if that suits your system better. Regardless of the approach, make sure that:
>
> - The user sees the informational text, so they understand what fraud reporting is and is not.
> - At least one reason category is selected, to ensure sufficient case information.
> - A contact email is provided, as it may be used for follow-up.

## View report status

Fetch the status of a fraud report for a specific invoice. Use this to check whether an invoice has already been reported, or to get the report ID needed to delete a report.

Use [GET /v1/invoices/{id}/reports](https://swagger.maventa.com/?urls.primaryName=STAGE%20-%20AutoXChange%20API#/invoices/getV1InvoicesIdReports).

## Delete a report

Allow users to delete a report they previously submitted, for example if they no longer suspect fraud or need to correct their report.

Use [DELETE /v1/invoices/{id}/reports/{report_id}](https://swagger.maventa.com/?urls.primaryName=STAGE%20-%20AutoXChange%20API#/invoices/deleteV1InvoicesIdReportsReportId).