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

# Get fraud categories

## OpenAPI

````json GET /v1/feedback/fraud-categories
{
  "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-categories": {
      "get": {
        "tags": [
          "Fraud"
        ],
        "summary": "Get Fraud Categories",
        "operationId": "get_fraud_categories_api_v1_feedback_fraud_categories_get",
        "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"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FraudCategoryResponse"
                },
                "examples": {
                  "possible_fraud_categories_and_descriptions": {
                    "value": {
                      "categories": [
                        {
                          "category": "document_is_manipulated",
                          "description": "Document is manipulated"
                        },
                        {
                          "category": "document_shown_from_screen",
                          "description": "Document is shown from screen"
                        },
                        {
                          "category": "document_is_printed_copy",
                          "description": "Document is a printed out copy"
                        },
                        {
                          "category": "selfie_shown_from_screen",
                          "description": "Selfie is shown from screen"
                        },
                        {
                          "category": "selfie_is_manipulated",
                          "description": "Selfie is manipulated"
                        },
                        {
                          "category": "selfie_document_portrait_mismatch",
                          "description": "Selfie does not match document portrait"
                        },
                        {
                          "category": "injected_media",
                          "description": "Media is injected"
                        },
                        {
                          "category": "false_decline",
                          "description": "False Decline"
                        },
                        {
                          "category": "transcription_failure",
                          "description": "Transcript data is wrong"
                        },
                        {
                          "category": "resubmission_false_decline",
                          "description": "Resubmission False Decline"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "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. The request format is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorPayload"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity. Input validation failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorPayload"
                }
              }
            }
          },
          "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=\"717\" class=\"editor360-table\" borderstyle=\"solid\" bordercollapse=\"collapse\" style=\"max-width: 717px; width: 717px;\"><colgroup><col style=\"width: 239px;\"><col style=\"width: 478px;\"></colgroup><tbody><tr><th colspan=\"1\" rowspan=\"1\" colwidth=\"239\" 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=\"239\" 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=\"239\" 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;\"><span type=\"spanMark\" style=\"font-size: 14px; box-sizing: border-box; outline: none;\">Aug 24, 2026</span></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;\"><span type=\"spanMark\" style=\"font-size: 14px; box-sizing: border-box; outline: none;\">Three new fraud categories added to response example:</span></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;\">false_decline</code> , <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;\">transcription_failure</code>, <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;\">resubmission_false_decline</code></p></td></tr><tr><td colspan=\"1\" rowspan=\"1\" colwidth=\"239\" 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-AUTH-CLIENT</code> header description updated</p></td></tr><tr><td colspan=\"1\" rowspan=\"1\" colwidth=\"239\" 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 25, 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;\">Examples restored</p></td></tr><tr><td colspan=\"1\" rowspan=\"1\" colwidth=\"239\" 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><tr><td colspan=\"1\" rowspan=\"1\" colwidth=\"239\" 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;\">Mar 12, 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;\">Documentation published</p></td></tr></tbody></table></div><p></p>"
      }
    }
  },
  "components": {
    "schemas": {
      "FraudCategoryResponse": {
        "properties": {
          "categories": {
            "items": {
              "$ref": "#/components/schemas/FraudCategory"
            },
            "type": "array",
            "title": "Categories",
            "description": "List of available fraud categories."
          }
        },
        "type": "object",
        "required": [
          "categories"
        ],
        "title": "FraudCategoryResponse",
        "description": "Response model containing the list of available fraud categories."
      },
      "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."
      },
      "FraudCategory": {
        "properties": {
          "category": {
            "type": "string",
            "title": "Category Code",
            "description": "Machine-readable code for the fraud category.",
            "example": "DOCUMENT_MANIPULATED"
          },
          "description": {
            "type": "string",
            "title": "Category Description",
            "description": "Human-readable description of the category.",
            "example": "Document appears to be digitally altered or forged."
          }
        },
        "type": "object",
        "required": [
          "category",
          "description"
        ],
        "title": "FraudCategory",
        "description": "Represents a single fraud category."
      }
    }
  }
}
````