> ## 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.

# Submit fraud report

## OpenAPI

````json POST /v1/feedback/fraud-reports
{
  "openapi": "3.0.2",
  "info": {
    "title": "Feedback API",
    "description": "Feedback API.<br>",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://feedback.api.veriff.com"
    }
  ],
  "paths": {
    "/v1/feedback/fraud-reports": {
      "post": {
        "tags": [
          "Fraud"
        ],
        "summary": "Submit fraud report",
        "operationId": "submit_fraud_report_api_v1_feedback_fraud_reports_post",
        "parameters": [
          {
            "name": "VRF-AUTH-CLIENT",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "API key"
          },
          {
            "name": "VRF-HMAC-SIGNATURE",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Full request path signed with the shared secret key"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FraudReportSubmission"
              },
              "examples": {
                "submitting_several_reports": {
                  "value": {
                    "reports": [
                      {
                        "sessionId": "d4f37a0d-2858-4270-aa74-0be2a78cadcb",
                        "categories": [
                          "document_is_manipulated"
                        ],
                        "comment": "Right side of the document appears to be cut off"
                      },
                      {
                        "sessionId": "cef3dc5b-4af1-476f-b75d-708dea4b7582",
                        "categories": [
                          "injected_media"
                        ],
                        "comment": "Media is injected"
                      }
                    ]
                  }
                },
                "submitting_one_report": {
                  "value": {
                    "reports": [
                      {
                        "sessionId": "d4f37a0d-2858-4270-aa74-0be2a78cadcb",
                        "categories": [
                          "document_is_manipulated"
                        ],
                        "comment": "Right side of the document appears to be cut off"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FraudReportResponse"
                },
                "examples": {
                  "reporting_success": {
                    "value": {
                      "reports": [
                        {
                          "sessionId": "d4f37a0d-2858-4270-aa74-0be2a78cadcb",
                          "reportId": "a565f8b9-9c0a-4e8e-95c4-94c4b51e150e",
                          "status": "reported"
                        }
                      ]
                    }
                  },
                  "reporting_success_and_error": {
                    "value": {
                      "reports": [
                        {
                          "sessionId": "d4f37a0d-2858-4270-aa74-0be2a78cadcb",
                          "reportId": "a565f8b9-9c0a-4e8e-95c4-94c4b51e150e",
                          "status": "reported"
                        },
                        {
                          "sessionId": "cef3dc5b-4af1-476f-b75d-708dea4b7582",
                          "reportId": "3a8d086a-bd10-4e66-ba29-a4d2671d0b49",
                          "status": "error",
                          "details": "The verification is in a state that cannot be reported."
                        }
                      ]
                    }
                  },
                  "reporting_error": {
                    "value": {
                      "reports": [
                        {
                          "sessionId": "cef3dc5b-4af1-476f-b75d-708dea4b7582",
                          "reportId": "3a8d086a-bd10-4e66-ba29-a4d2671d0b49",
                          "status": "error",
                          "details": "The verification is in a state that cannot be reported."
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized. Possible reasons: Invalid API key or signature.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorPayload"
                },
                "examples": {
                  "invalidApiKey": {
                    "value": {
                      "code": "1803",
                      "message": "Integration with the API key '6ee9e344-20a6-439d-bf21-b6610db63ad6' was not found."
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests. Rate limit exceeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorPayload"
                },
                "examples": {
                  "rateLimitExceeded": {
                    "value": {
                      "code": "RATE_LIMIT_EXCEEDED",
                      "message": "Limit exceeded: 1000 per minute"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request. Possible reasons: Invalid categories, invalid session state, report already exists.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorPayload"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity. Input validation failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorPayload"
                },
                "examples": {
                  "categoriesFieldRequired": {
                    "value": {
                      "code": "UNPROCESSABLE_ENTITY",
                      "message": "Validation failed: reports: Field required"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error. An unexpected error occurred.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorPayload"
                },
                "examples": {
                  "internalServerError": {
                    "value": {
                      "code": "INTERNAL_SERVER_ERROR",
                      "message": "An unexpected error occurred."
                    }
                  }
                }
              }
            }
          }
        },
        "x-d360-narrative-responses": "<p></p><p></p><p><strong>Changelog</strong></p><div data-type=\"table-content\"><table width=\"703\" class=\"editor360-table\" borderstyle=\"solid\" bordercollapse=\"collapse\" style=\"max-width: 703px; width: 703px;\"><colgroup><col style=\"width: 225px;\"><col style=\"width: 478px;\"></colgroup><tbody><tr><th colspan=\"1\" rowspan=\"1\" colwidth=\"225\" style=\"box-sizing: border-box; outline: none; text-align: -webkit-match-parent; border-color: inherit; border-style: solid; border-width: 1px; height: 40px; font-weight: 600;\"><p style=\"box-sizing: border-box; outline: none; margin: 0px; font-weight: 600; font-size: 14px;\"><strong>Date</strong></p></th><th colspan=\"1\" rowspan=\"1\" colwidth=\"478\" style=\"box-sizing: border-box; outline: none; text-align: -webkit-match-parent; border-color: inherit; border-style: solid; border-width: 1px; height: 40px; font-weight: 600;\"><p style=\"box-sizing: border-box; outline: none; margin: 0px; font-weight: 600; font-size: 14px;\"><strong>Description</strong></p></th></tr><tr><td colspan=\"1\" rowspan=\"1\" colwidth=\"225\" style=\"box-sizing: border-box; outline: none; border-color: inherit; border-style: solid; border-width: 1px; height: 40px;\"><p style=\"box-sizing: border-box; outline: none; margin: 0px; font-size: 14px;\">Oct 16, 2025</p></td><td colspan=\"1\" rowspan=\"1\" colwidth=\"478\" style=\"box-sizing: border-box; outline: none; border-color: inherit; border-style: solid; border-width: 1px; height: 40px;\"><p style=\"box-sizing: border-box; outline: none; margin: 0px; font-size: 14px;\">API docs location updated</p></td></tr><tr><td colspan=\"1\" rowspan=\"1\" colwidth=\"225\" style=\"box-sizing: border-box; outline: none; border-color: inherit; border-style: solid; border-width: 1px; height: 40px;\"><p style=\"box-sizing: border-box; outline: none; margin: 0px; font-size: 14px;\">Aug 24, 2026</p></td><td colspan=\"1\" rowspan=\"1\" colwidth=\"478\" style=\"box-sizing: border-box; outline: none; border-color: inherit; border-style: solid; border-width: 1px; height: 40px;\"><p style=\"box-sizing: border-box; outline: none; margin: 0px; font-size: 14px;\">- <code style=\"box-sizing: border-box; outline: none; font-family: SFMono-Regular, Menlo, Monaco, Consolas, &quot;Liberation Mono&quot;, &quot;Courier New&quot;, monospace; overflow-wrap: break-word; padding: 0.125rem 0.375rem; border-radius: 0.3125rem; line-height: 1rem; caret-color: rgb(214, 51, 132); font-size: inherit !important;\">user_uuid</code> changed to <code style=\"box-sizing: border-box; outline: none; font-family: SFMono-Regular, Menlo, Monaco, Consolas, &quot;Liberation Mono&quot;, &quot;Courier New&quot;, monospace; overflow-wrap: break-word; padding: 0.125rem 0.375rem; border-radius: 0.3125rem; line-height: 1rem; caret-color: rgb(214, 51, 132); font-size: inherit !important;\">userUuid</code> </p><p style=\"box-sizing: border-box; outline: none; margin: 0px; font-size: 14px;\">- <code style=\"box-sizing: border-box; outline: none; font-family: SFMono-Regular, Menlo, Monaco, Consolas, &quot;Liberation Mono&quot;, &quot;Courier New&quot;, monospace; overflow-wrap: break-word; padding: 0.125rem 0.375rem; border-radius: 0.3125rem; line-height: 1rem; caret-color: rgb(214, 51, 132); font-size: inherit !important;\">comment</code> parameter format constraint removed</p></td></tr><tr><td colspan=\"1\" rowspan=\"1\" colwidth=\"225\" style=\"box-sizing: border-box; outline: none; border-color: inherit; border-style: solid; border-width: 1px; height: 40px;\"><p style=\"box-sizing: border-box; outline: none; margin: 0px; font-size: 14px;\">Dec 19, 2025</p></td><td colspan=\"1\" rowspan=\"1\" colwidth=\"478\" style=\"box-sizing: border-box; outline: none; border-color: inherit; border-style: solid; border-width: 1px; height: 40px;\"><p style=\"box-sizing: border-box; outline: none; margin: 0px; font-size: 14px;\"><code style=\"box-sizing: border-box; outline: none; font-family: SFMono-Regular, Menlo, Monaco, Consolas, &quot;Liberation Mono&quot;, &quot;Courier New&quot;, monospace; overflow-wrap: break-word; padding: 0.125rem 0.375rem; border-radius: 0.3125rem; line-height: 1rem; caret-color: rgb(214, 51, 132); font-size: inherit !important;\">VRF-HMAC-SIGNATURE</code> header description updated</p></td></tr><tr><td colspan=\"1\" rowspan=\"1\" colwidth=\"225\" style=\"box-sizing: border-box; outline: none; border-color: inherit; border-style: solid; border-width: 1px; height: 40px;\"><p style=\"box-sizing: border-box; outline: none; margin: 0px; font-size: 14px;\">Nov 6, 2025</p></td><td colspan=\"1\" rowspan=\"1\" colwidth=\"478\" style=\"box-sizing: border-box; outline: none; border-color: inherit; border-style: solid; border-width: 1px; height: 40px;\"><p style=\"box-sizing: border-box; outline: none; margin: 0px; font-size: 14px;\">\"Article Versioning\" changed to \"Changelog\"</p></td></tr><tr><td colspan=\"1\" rowspan=\"1\" colwidth=\"225\" style=\"box-sizing: border-box; outline: none; border-color: inherit; border-style: solid; border-width: 1px; height: 40px;\"><p style=\"box-sizing: border-box; outline: none; margin: 0px; font-size: 14px;\">Oct 3, 2025</p></td><td colspan=\"1\" rowspan=\"1\" colwidth=\"478\" style=\"box-sizing: border-box; outline: none; border-color: inherit; border-style: solid; border-width: 1px; height: 40px;\"><p style=\"box-sizing: border-box; outline: none; margin: 0px; font-size: 14px;\">Note about pre-release removed</p></td></tr></tbody></table></div><p></p>"
      }
    }
  },
  "components": {
    "schemas": {
      "FraudReportSubmission": {
        "properties": {
          "reports": {
            "items": {
              "$ref": "#/components/schemas/FraudReportItem"
            },
            "type": "array",
            "minItems": 1,
            "title": "Reports",
            "description": "List of fraud reports to submit."
          }
        },
        "type": "object",
        "required": [
          "reports"
        ],
        "title": "FraudReportSubmission",
        "description": "Request body model for submitting one or more fraud reports."
      },
      "FraudReportResponse": {
        "properties": {
          "reports": {
            "items": {
              "$ref": "#/components/schemas/FraudReportResponseItem"
            },
            "type": "array",
            "title": "Report Results",
            "description": "Detailed results for each individual report submission, including status and error details if applicable."
          },
          "processedCount": {
            "type": "integer",
            "title": "Processed Count",
            "description": "Total number of reports received and processed in this request batch.",
            "example": 2
          },
          "successCount": {
            "type": "integer",
            "title": "Success Count",
            "description": "Number of reports that were successfully submitted and recorded.",
            "example": 1
          },
          "errorCount": {
            "type": "integer",
            "title": "Error Count",
            "description": "Number of reports that failed validation or processing.",
            "example": 1
          }
        },
        "type": "object",
        "required": [
          "reports",
          "processedCount",
          "successCount",
          "errorCount"
        ],
        "title": "FraudReportResponse",
        "description": "Response model for fraud report submission, providing both detailed per-item results and summary statistics for the batch operation."
      },
      "ErrorPayload": {
        "type": "object",
        "required": [
          "code",
          "message"
        ],
        "properties": {
          "code": {
            "type": "string",
            "title": "Error Code",
            "description": "A machine-readable error code indicating the type of error.",
            "example": "BAD_REQUEST"
          },
          "message": {
            "type": "string",
            "title": "Error Message",
            "description": "A human-readable message explaining the error.",
            "example": "The categories are not valid."
          }
        },
        "title": "ErrorPayload",
        "description": "Generic error response structure."
      },
      "FraudReportItem": {
        "properties": {
          "sessionId": {
            "type": "string",
            "format": "uuid",
            "title": "Session ID",
            "description": "The unique identifier of the Veriff session being reported."
          },
          "categories": {
            "items": {
              "type": "string",
              "description": "A fraud category code (obtainable from `/fraud-categories`).",
              "example": "DOCUMENT_MANIPULATED"
            },
            "type": "array",
            "minItems": 1,
            "uniqueItems": true,
            "title": "Categories",
            "description": "List of fraud category codes associated with this report."
          },
          "comment": {
            "type": "string",
            "nullable": true,
            "title": "Comment",
            "description": "Optional additional details or context about the fraud report (max 500 characters recommended).",
            "example": "Document corners appear cropped; possible tampering."
          },
          "userUuid": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "title": "User UUID",
            "description": "The unique identifier of the user who creates the report.",
            "example": "d6c23ba2-100a-4361-995e-bb57c29ba5f2"
          }
        },
        "type": "object",
        "required": [
          "sessionId",
          "categories"
        ],
        "title": "FraudReportItem",
        "description": "Represents a single fraud report within a submission request."
      },
      "FraudReportResponseItem": {
        "properties": {
          "sessionId": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "title": "Session ID",
            "description": "The session ID corresponding to this report result."
          },
          "reportId": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "title": "Report ID",
            "description": "The unique ID assigned to the successfully processed fraud report. Null if processing failed."
          },
          "status": {
            "type": "string",
            "enum": [
              "reported",
              "error"
            ],
            "example": "reported",
            "title": "Status",
            "description": "The processing status of this individual report ('reported' or 'error')."
          },
          "details": {
            "type": "string",
            "nullable": true,
            "title": "Details",
            "example": "null",
            "description": "Provides error details if the status is 'error', otherwise null."
          }
        },
        "type": "object",
        "required": [
          "sessionId",
          "status"
        ],
        "title": "FraudReportResponseItem",
        "description": "Represents the processing result for a single fraud report within a batch submission."
      }
    }
  }
}
````