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

# Introduction

> Integrate VOORA Antifraud to screen events, retrieve decisions, and investigate risk alerts.

## Overview

VOORA Antifraud API helps you evaluate transaction events and return actionable fraud decisions in real time.

For each submitted event, the API can return:

* `APPROVE`, `REVIEW`, or `DECLINE` decision (`actionType`)
* A risk score (`totalRiskScore`, 0-100)
* Rule and list matches that explain the decision

## Authentication

All endpoints require a client API key in this header:

* `X-CLIENT-API-KEY: <your_api_key>`

Requests without a valid key return `401`, and blocked merchants return `403`.

## Core Workflow

1. `POST /event`\
   Submit an event payload for fraud screening.

2. `GET /event/{eventId}`\
   Fetch event details and decision state.

3. `GET /event/{eventId}/risk-assessment`\
   Fetch detailed risk alerts for investigation/explanations.

4. `PATCH /event/{eventId}/state`\
   Update event state (manual review/operations flow).
