---
title: "Retrieve fraud reports"
slug: "retrieve-fraud-reports"
description: "Retrieve detailed fraud reports by session IDs, including verification data and QA reviews, with clear status updates for each report."
updated: 2025-12-19T13:16:01Z
published: 2025-12-19T13:16:01Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.veriff.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve fraud reports

Post/v1/feedback/fraud-reports/retrieve

		
			

**Retrieve fraud reports by session IDs.**

This endpoint accepts a list of session IDs and returns detailed information about each fraud report, including verification session data, QA reviews, and decision information.

Response Statuses Per Report: Each item in the `reports` array of the response will have a `status`:

- `FOUND`: The fraud report was found and detailed information is provided in the `details` field
- `NOT_FOUND`: The report could not be found or is not accessible. The `errorMessage` field will contain the `reason`

		
		

Header parametersVRF-AUTH-CLIENTstringRequired

Your integration's API key, can be found in Customer Portal

VRF-HMAC-SIGNATUREstringRequired

Full request path and request payload body signed with the shared secret key. There must be a new line break between the endpoint URL and the payload body ("\n" or any alternative logic in other programming language). See [HMAC Authentication and Endpoint Security](https://devdocs.veriff.com/docs/hmac-authentication-and-endpoint-security) for more info.

Body parameters<select class='api-response-data' aria-label='Media type'><option value='202d484b-e261-4b43-ab95-06903b0daeb7'>application/json</option>
</select>object  

Request body model for retrieving fraud reports by session IDs.

sessionIds Array of string   Required

List of session IDs to retrieve fraud reports for (max 10 per request).

Min items1Max items10Example[
  "a65ba93a-83d8-41bc-9a0d-e2ec2a8f046c",
  "d07f2b48-4dc2-4470-a183-ed6032a68081"
]string  (uuid)    

A session ID associated with a fraud report.

Responses200

Successful Response

<select class='api-response-data' aria-label='Media type'><option value='edc40e64-e191-4791-b315-001187a48f44'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='a3e936b4-74ef-4731-a80a-a3d8896cdfdd'>reports_retrieved_example</option>
</select>reports_retrieved_example

```json
{
  "reports": [
    {
      "sessionId": "a65ba93a-83d8-41bc-9a0d-e2ec2a8f046c",
      "status": "FOUND",
      "details": {
        "reportId": "a65bc00c-83d8-41bc-4a2s-e2ec2a8f089e",
        "sessionId": "a65bc00c-11d8-51bc-4a2s-e2dd2a8f089e",
        "reportedBy": "user@example.com",
        "status": "Reviewed",
        "verifiedAt": "2024-01-15T09:30:00Z",
        "reportedAt": "2024-01-15T10:30:00Z",
        "reviewedAt": "2024-01-15T11:30:00Z",
        "fraudTypeReported": [
          "CATEGORY_1"
        ],
        "customerComment": "Document appears to be digitally altered",
        "initialDecision": "Decline",
        "finalDecision": "Decline",
        "reviewDecision": "Agree",
        "resetFp": false,
        "decisionErrorDescription": "Decision Profile Check (some_check): d07f2b48-4dc2-4470-a183-ed6032a68081: Check Result: sucess → QA Result: failure Decision Profile Check (some_other_check): d07f2b48-4dc2-4470-a183-ed6032a68081: Check Result: sucess → QA Result: failure"
      },
      "errorMessage": "Report not found or not accessible",
      "processedCount": 2,
      "foundCount": 1,
      "notFoundCount": 1
    }
  ]
}
```

Expand Allobject  

Response model for fraud report retrieval, providing both detailed per-item results and summary statistics for the batch operation.

reports Array of object (FraudReportRetrieveResponseItem)   

Detailed results for each individual report retrieval, including status and detailed information if found.

object  

Represents the retrieval result for a single fraud report within a batch request.

sessionIdstring  (uuid)    

The session ID that was queried.

Examplea65ba93a-83d8-41bc-9a0d-e2ec2a8f046c
statusstring    

The retrieval status of this report ('FOUND' or 'NOT_FOUND').

Valid values[
  "FOUND",
  "NOT_FOUND"
]ExampleFOUND
detailsobject (FraudReportDetailedInfo)  

Detailed information about a fraud report including verification session data, QA reviews, and decisions.

reportIdstring  (uuid)    

The unique identifier for this fraud report.

Examplea65bc00c-83d8-41bc-4a2s-e2ec2a8f089e
sessionIdstring  (uuid)    

The last session ID associated with this report.

Examplea65bc00c-11d8-51bc-4a2s-e2dd2a8f089e
reportedBystring    

The user email or automation that reported this fraud.

Exampleuser@example.com
statusstring    

Status of the report (e.g., 'Reviewed', 'Received').

ExampleReviewed
verifiedAtstring  (date-time)   | null  

Timestamp when the verification session was verified.

Example2024-01-15T09:30:00Z
reportedAtstring  (date-time)    

Timestamp when the fraud report was submitted.

Example2024-01-15T10:30:00Z
reviewedAtstring  (date-time)   | null  

Timestamp when the report was reviewed.

Example2024-01-15T11:30:00Z
fraudTypeReported Array of string   

List of fraud category codes reported for this session.

string    

A fraud category code.

ExampleCATEGORY_1
customerCommentstring   | null  

Optional comment provided during reporting.

ExampleDocument appears to be digitally altered
initialDecisionstring   | null  

Initial decision made for this verification (Approve/Resubmission/Decline/Review).

ExampleDecline
finalDecisionstring   | null  

Final decision made for this verification (Approve/Resubmission/Decline).

ExampleDecline
resetFpboolean   | null  

Indicates if this was marked as a false positive that was reset.

Examplefalse
reviewDecisionstring   | null  

Decision of the QA review (Agree/Disagree).

ExampleAgree
decisionErrorDescriptionstring   | null  

Description of any decision errors if applicable.

ExampleDecision Profile Check (some_check): d07f2b48-4dc2-4470-a183-ed6032a68081: Check Result: sucess → QA Result: failure Decision Profile Check (some_other_check): d07f2b48-4dc2-4470-a183-ed6032a68081: Check Result: sucess → QA Result: failure

errorMessagestring   | null  

Error message if the report was not found.

ExampleReport not found or not accessible

processedCountinteger    

Total number of session IDs processed in this request.

Example2
foundCountinteger    

Number of reports that were successfully found.

Example1
notFoundCountinteger    

Number of reports that were not found or not accessible.

Example1

400

Bad Request. Possible reasons: Invalid request format, no session IDs provided, or more than 10 session IDs provided.

<select class='api-response-data' aria-label='Media type'><option value='12e2e43a-3ad7-464f-a15a-dbe9a3b362b8'>application/json</option>
</select>object  

Generic error response structure.

codestring    

A machine-readable error code indicating the type of error.

ExampleBAD_REQUEST
messagestring    

A human-readable message explaining the error.

ExampleThe categories are not valid.

401

Unauthorized. Possible reasons: Invalid API key or signature.

<select class='api-response-data' aria-label='Media type'><option value='864a20e2-1344-411d-a495-b60c44222475'>application/json</option>
</select>object  

Generic error response structure.

codestring    

A machine-readable error code indicating the type of error.

ExampleBAD_REQUEST
messagestring    

A human-readable message explaining the error.

ExampleThe categories are not valid.

422

Unprocessable Entity. Input validation failed.

<select class='api-response-data' aria-label='Media type'><option value='d8dd4d30-da3d-44ab-9871-3aea975b7df2'>application/json</option>
</select>object  

Generic error response structure.

codestring    

A machine-readable error code indicating the type of error.

ExampleBAD_REQUEST
messagestring    

A human-readable message explaining the error.

ExampleThe categories are not valid.

429

Too Many Requests. Rate limit exceeded.

<select class='api-response-data' aria-label='Media type'><option value='668439c5-1d54-44c5-8069-6158709c097b'>application/json</option>
</select>object  

Generic error response structure.

codestring    

A machine-readable error code indicating the type of error.

ExampleBAD_REQUEST
messagestring    

A human-readable message explaining the error.

ExampleThe categories are not valid.

500

Internal Server Error. An unexpected error occurred.

<select class='api-response-data' aria-label='Media type'><option value='cd8cf000-b1d1-480f-9eb8-110a148aac0b'>application/json</option>
</select>object  

Generic error response structure.

codestring    

A machine-readable error code indicating the type of error.

ExampleBAD_REQUEST
messagestring    

A human-readable message explaining the error.

ExampleThe categories are not valid.

		
			

<title style="font-size:15px;">Document Versioning</title>

**Changelog**

| Date | Description |
| --- | --- |
| Dec 19, 2025 | VRF-HMAC-SIGNATURE header description updated |
| Nov 28, 2025 | Response payload example added |
| Nov 26, 2025 | Example data for `decisionErrorDescription` added |
| Nov 6, 2025 | Documentation published |