# Upload a ZIP file for fraud analysis

This endpoint allows you to upload a ZIP file to analyze contained image and document files in the context of a specific case.

 


Endpoint: POST /v2/fraudscanner
Version: v2.3.1
Security: apiKeyAuth

## Header parameters:

  - `x-api-key` (string, required)
    The API key for authentication.

  - `caseNumber` (string, required)
    A case number to assign to the request. Typically matches the one that you use internally to track the files you're sending us.

  - `issueDate` (string)
    The issue date of the case, if available.

## Request fields (multipart/form-data):

  - `file` (string, required)
    The ZIP file to be uploaded for analysis.

## Response 200 fields (application/json):

  - `suspicion_level` (string)
    An indicator as to how suspicious the contents of the request were. Is calculated from the suspicion levels of the contained files.
    Enum: "Green", "Yellow", "Red"

  - `Files` (object)
    A mapping of filename to file analysis results.

  - `caseNumber` (string)
    The case number assigned to the request.
    Example: "Case 123A"

  - `sessionId` (string)
    A unique identifier generated for the request.
    Example: "5a8d8fd2-3317-4964-8298-caa96cd5cfa3"

  - `modelVersions` (object)
    Overview of the internal VAARHAFT AI models used for classification.

  - `modelVersions.generatedModelVersion` (string)
    The VAARHAFT AI model used for detection of AI generated images.
    Example: "vh-gen-uranus"

  - `modelVersions.tamperedModelVersion` (string)
    The VAARHAFT AI model used for detection of edited images.
    Example: "vh-tp-venus"

  - `modelVersions.semanticModelVersion` (string)
    The VAARHAFT AI model used for semantic analysis of images.
    Example: "vh-sem-mars"

  - `tokensConsumed` (integer)
    The amount of API tokens that were consumed by this request, depending for example on the number and types of processed files.
    Example: 12

## Response 400 fields (application/json):

  - `detail` (string)
    Details about why the request was not successful.
    Example: "Some error details."

## Response 413 fields (application/json):

  - `detail` (string)
    Details about why the request was not successful.
    Example: "Some error details."

## Response 422 fields (application/json):

  - `detail` (string)
    Details about why the request was not successful.
    Example: "Some error details."

## Response 429 fields (application/json):

  - `detail` (string)
    Details about why the request was not successful.
    Example: "Some error details."

## Response 500 fields (application/json):

  - `detail` (string)
    Details about why the request was not successful.
    Example: "Some error details."

## Response 501 fields (application/json):

  - `detail` (string)
    Details about why the request was not successful.
    Example: "Some error details."