API Documentation

Start detecting fraud in minutes

Simple REST API for real-time fraud detection. Get started with just a few lines of code.

Documentation

Quick Start

Get started with Rifraux in 3 simple steps:

1
Get your API key
Sign up and generate your API key from the dashboard
2
Make your first API call
Send a transaction for fraud scoring
3
Integrate into your system
Add fraud detection to your transaction flow

Authentication

Authenticate your API requests using the X-API-Key header:

X-API-Key: rfx_your_api_key_here

Security Tip: Never expose your API key in client-side code. Always make API calls from your backend server.

API Endpoints

POST/v1/check/ato

Score a Account Takeover request for fraud

curl -X POST https://api.rifraux.com/v1/check/ato \
    -H "X-API-Key: rfx_your_api_key_here" \
    -H "Content-Type: application/json" \
    -d '{
      "user_id": "U123457",
      "session_id": "S0000000001",
      "device_id": "D12345578",
      "ip_address": "197.210.44.456",
      "action_type": "transfer",
      "amount": 1000.0,
      "channel": "mobile_app",
      "biometric_used": false,
      "latitude": 34.0522,
      "longitude": -118.2437,
      "is_2fa_enabled": true,
      "device_model_raw": "iPhone14,2",
      "sim_details_raw": "SIM_ID_A"
    }'

Example JSON Response

{
    "request_id": "db3da698c2fac949",
    "fraud_type": "ato",
    "fraud_probability": 0.23,
    "is_fraud": false,
    "risk_level": "LOW",
    "action": "allow",
    "reasons": ["Low fraud probability detected"],
    "confidence": 0.23,
    "timestamp": "2026-01-23T10:30:01",
    "processing_time_ms": 105.74,
    "top_risk_factors": [
      {
        "feature": "device_age_hours",
        "importance": 0.25,
        "value": 720.0
      }
    ]
  }

POST/v1/check/batch

Score multiple transactions in a single request

Ready to get started?

Generate your API key and start protecting your transactions in minutes

Get Your API Key →