API Overview

Fraud Sentinel is an enterprise-grade, real-time fraud detection API. It analyzes identity, behavior, email, crypto wallet, document, and transaction data to return an instant risk score (0–100) with a clear risk band and explainable signal breakdown. All fields are optional — send what you have, and the scoring adapts based on data completeness.

Documentation: https://fraudsentinel.org/docs

Support: fraudsentinel@protonmail.com

Endpoints

1. POST /v1/fraud/score

Submit data to receive a comprehensive fraud risk assessment. All input sections are optional — include more for higher accuracy.

Standard Fraud Check (Identity + Email + Transaction)

curl -X POST "https://fraud-sentinel.p.rapidapi.com/v1/fraud/score" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: fraud-sentinel.p.rapidapi.com" \
  -d '{
    "identity": {
      "firstName": "John",
      "lastName": "Doe",
      "country": "US"
    },
    "contact": {
      "email": "john.doe@example.com",
      "ip": "198.51.100.5"
    },
    "transaction": {
      "amount": 750.50,
      "currency": "USD"
    }
  }'

Email-Only Check (Minimal)

curl -X POST "https://fraud-sentinel.p.rapidapi.com/v1/fraud/score" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: fraud-sentinel.p.rapidapi.com" \
  -d '{
    "contact": {
      "email": "suspicious@tempmail.xyz"
    }
  }'

Signup / Onboarding Check

curl -X POST "https://fraud-sentinel.p.rapidapi.com/v1/fraud/score" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: fraud-sentinel.p.rapidapi.com" \
  -d '{
    "identity": {
      "firstName": "Jane",
      "lastName": "Smith",
      "dob": "1990-05-20",
      "country": "GB"
    },
    "contact": {
      "email": "jane.smith@gmail.com",
      "ip": "203.0.113.42"
    },
    "behavior": {
      "accountAgeDays": 0,
      "loginCountLast24h": 1,
      "transactionsLast24h": 0,
      "countriesLast24h": ["GB"],
      "priorChargebacks": 0
    }
  }'

Crypto Wallet Check

curl -X POST "https://fraud-sentinel.p.rapidapi.com/v1/fraud/score" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: fraud-sentinel.p.rapidapi.com" \
  -d '{
    "crypto": {
      "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28",
      "network": "ETH",
      "walletAgeDays": 5,
      "totalTransactions": 2
    }
  }'

Document Verification Check

curl -X POST "https://fraud-sentinel.p.rapidapi.com/v1/fraud/score" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: fraud-sentinel.p.rapidapi.com" \
  -d '{
    "document": {
      "documentType": "passport",
      "hash": "e3b0c44298fc1c149afbf4c8996fb924",
      "fileSize": 245000,
      "createdAt": "2025-06-15T10:30:00Z",
      "modifiedAt": "2026-01-20T14:22:00Z",
      "metadata": {
        "issuedCountry": "US",
        "expiresAt": "2030-06-15T00:00:00Z",
        "softwareUsed": "Adobe Photoshop"
      }
    }
  }'

Full Combined Check (All 6 Signals)

curl -X POST "https://fraud-sentinel.p.rapidapi.com/v1/fraud/score" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: fraud-sentinel.p.rapidapi.com" \
  -d '{
    "identity": {
      "firstName": "John",
      "lastName": "Doe",
      "dob": "1993-01-15",
      "country": "US"
    },
    "contact": {
      "email": "john.doe@example.com",
      "phone": "+15551234567",
      "ip": "198.51.100.5"
    },
    "behavior": {
      "accountAgeDays": 30,
      "loginCountLast24h": 3,
      "transactionsLast24h": 2,
      "countriesLast24h": ["US"],
      "priorChargebacks": 0
    },
    "transaction": {
      "amount": 750.50,
      "currency": "USD"
    },
    "crypto": {
      "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28",
      "network": "ETH",
      "walletAgeDays": 120,
      "totalTransactions": 45
    },
    "document": {
      "documentType": "passport",
      "hash": "e3b0c44298fc1c149afbf4c8996fb924",
      "fileSize": 245000,
      "createdAt": "2025-06-15T10:30:00Z",
      "modifiedAt": "2026-01-20T14:22:00Z",
      "metadata": {
        "issuedCountry": "US",
        "expiresAt": "2030-06-15T00:00:00Z"
      }
    }
  }'

Example Response

{
  "requestId": "fr_abc123xyz",
  "overallScore": 15,
  "riskBand": "LOW",
  "components": {
    "identityForgingScore": 10,
    "fakeNameScore": 0,
    "behaviorScore": 5,
    "emailRiskScore": 5,
    "cryptoWalletRiskScore": 0,
    "documentTamperingScore": 0
  },
  "flags": ["free_email_provider"],
  "explanations": [],
  "meta": {
    "processingTimeMs": 45,
    "serverTimestamp": "2026-01-30T12:00:00.000Z",
    "cached": false
  }
}

2. GET /v1/health

Check API availability and signal status. No authentication required.

curl "https://fraud-sentinel.p.rapidapi.com/v1/health"

Example Response

{
  "status": "healthy",
  "service": "Fraud Sentinel API",
  "version": "1.0.0",
  "timestamp": "2026-01-30T12:00:00.000Z",
  "signals": {
    "identityForging": "operational",
    "fakeName": "operational",
    "behavior": "operational",
    "emailRisk": "operational",
    "cryptoWallet": "operational",
    "documentTampering": "operational"
  }
}

Signals Reference

Fraud Sentinel evaluates 6 independent signals. Each produces a score from 0–100. The overall score is a weighted combination:

Signal	Weight	Required Input	What It Detects
Identity Forging	20%	`identity`	Synthetic identities, name anomalies, high-risk jurisdictions
Fake Name Detection	15%	`identity`	Test names, celebrity names, keyboard patterns, numeric anomalies
Behavior Analysis	25%	`behavior`	Login velocity, impossible travel, transaction spikes, new accounts
Email Risk	15%	`contact.email`	Disposable emails, typo-squatting, suspicious patterns
Crypto Wallet Risk	15%	`crypto`	Sanctioned wallets, mixer usage, high-risk networks, new wallets
Document Tampering	10%	`document`	Edited metadata, Photoshop artifacts, date inconsistencies

Pricing & Plans

Plan	Price	Monthly Requests	Rate Limit	Signals Included
Basic	Free	100	1 req/sec	Identity, Email
Pro	$49/month	10,000	10 req/sec	All core signals (Identity, Email, Behavior)
Ultra	$199/month	100,000	50 req/sec	All signals including Velocity, Device, Crypto, Document
Mega	$499/month	500,000	100 req/sec	All signals + custom scoring models

Rate Limit Headers

Every response includes these headers:

Header	Description
`X-RateLimit-Limit`	Requests allowed per second for your plan
`X-RateLimit-Remaining`	Remaining requests in current window
`X-RateLimit-Reset`	Unix timestamp when rate limit resets
`X-Monthly-Quota-Remaining`	Remaining monthly API requests
`X-Cache`	Cache status (HIT or MISS)

Error Codes

Status	Error	Meaning
400	`validation_error`	Invalid request body or field values
401	`invalid_api_key`	Missing or invalid X-RapidAPI-Key
403	`subscription_inactive`	Subscription inactive or plan does not have access
429	`quota_exceeded`	Rate limit or monthly quota exceeded — upgrade your plan
500	`internal_error`	Unexpected server error — retry later

Best Practices

Send all available data. More fields = more accurate scores. All inputs are optional, so send what you have.
Use risk bands for decisioning: LOW (0–30) auto-approve, MEDIUM (31–65) request verification, HIGH (66–100) block or manual review.
Check the flags array to build custom business rules (e.g., always block disposable_email for financial transactions).
Handle 429s gracefully. Implement exponential backoff and check X-RateLimit-Remaining to pre-emptively throttle.
Call from your backend only. Never expose your API key in client-side code.
Caching: Identical requests within 10 minutes return cached results (X-Cache: HIT).

Full documentation: https://fraudsentinel.org/docs

Support: fraudsentinel@protonmail.com