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 thedetailsfieldNOT_FOUND: The report could not be found or is not accessible. TheerrorMessagefield will contain thereason
API key
Full request path signed with the shared secret key
Request body model for retrieving fraud reports by session IDs.
List of session IDs to retrieve fraud reports for (max 10 per request).
A session ID associated with a fraud report.
Successful Response
{
"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
}
]
}Response model for fraud report retrieval, providing both detailed per-item results and summary statistics for the batch operation.
Detailed results for each individual report retrieval, including status and detailed information if found.
Represents the retrieval result for a single fraud report within a batch request.
The session ID that was queried.
The retrieval status of this report ('FOUND' or 'NOT_FOUND').
Detailed information about a fraud report including verification session data, QA reviews, and decisions.
The unique identifier for this fraud report.
The last session ID associated with this report.
The user email or automation that reported this fraud.
Status of the report (e.g., 'Reviewed', 'Received').
Timestamp when the verification session was verified.
Timestamp when the fraud report was submitted.
Timestamp when the report was reviewed.
List of fraud category codes reported for this session.
A fraud category code.
Optional comment provided during reporting.
Initial decision made for this verification (Approve/Resubmission/Decline/Review).
Final decision made for this verification (Approve/Resubmission/Decline).
Indicates if this was marked as a false positive that was reset.
Decision of the QA review (Agree/Disagree).
Description of any decision errors if applicable.
Error message if the report was not found.
Total number of session IDs processed in this request.
Number of reports that were successfully found.
Number of reports that were not found or not accessible.
Bad Request. Possible reasons: Invalid request format, no session IDs provided, or more than 10 session IDs provided.
Generic error response structure.
A machine-readable error code indicating the type of error.
A human-readable message explaining the error.
Unauthorized. Possible reasons: Invalid API key or signature.
Generic error response structure.
A machine-readable error code indicating the type of error.
A human-readable message explaining the error.
Unprocessable Entity. Input validation failed.
Generic error response structure.
A machine-readable error code indicating the type of error.
A human-readable message explaining the error.
Too Many Requests. Rate limit exceeded.
Generic error response structure.
A machine-readable error code indicating the type of error.
A human-readable message explaining the error.
Internal Server Error. An unexpected error occurred.
Generic error response structure.
A machine-readable error code indicating the type of error.
A human-readable message explaining the error.
Changelog
Date | Description |
|---|---|
Nov 28, 2025 | Response payload example added |
Nov 26, 2025 | Example data for |
Nov 6, 2025 | Documentation published |