API Documentation

Start detecting losses in minutes

Simple REST APIs for real-time fraud detection and industrial IoT intelligence. Get started with just a few lines of code.

Financial Docs

Base URL

https://api.rifraux.com/v1

Quick Start

Get started with Rifraux fraud APIs 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 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 }
  ]
}

Ready to get started?

Generate your API key and start protecting your transactions in minutes.

Get Your API Key →