API Overview

EntityRisk is an enterprise-grade risk intelligence API for screening people and organizations. It returns a single unified risk score (0-100) with an explainable breakdown covering:

PEP Screening — Politically Exposed Persons with fuzzy matching and similarity scoring
Adverse Media — Keyword extraction and risk signal analysis
Fraud Indicators — Jurisdiction flags and pattern-based signals

Built for KYC/KYB onboarding, compliance workflows, fraud prevention, and internal risk tooling.

Quick Start

Subscribe to a plan on this page
Use the Test Endpoint tab — RapidAPI sends your API key automatically
Call POST /risk-score with the entity name

curl -X POST "https://entityrisk.p.rapidapi.com/risk-score" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: entityrisk.p.rapidapi.com" \
  -d '{
    "name": "John Smith",
    "country": "United States",
    "dob": "1975-03-15"
  }'

Risk Bands

The unified score maps to these action thresholds:

Score	Level	Recommended Action
`0–24`	LOW	Allow / low risk
`25–49`	MEDIUM	Review recommended
`50–69`	HIGH	Enhanced due diligence (EDD)
`70–100`	CRITICAL	Block / escalate immediately

Endpoints

POST /risk-score

Screen an entity and receive a unified risk score with detailed breakdown.

Request Body:

{
  "name": "John Smith",          // Required
  "aliases": ["J. Smith"],       // Optional
  "dob": "1975-03-15",           // Optional (YYYY-MM-DD)
  "country": "United States",    // Optional
  "identifiers": {               // Optional
    "passport": "123456789"
  }
}

Response:

{
  "request_id": "uuid",
  "unified_score": 45,
  "risk_level": "medium",
  "breakdown": {
    "pep_score": 30,
    "adverse_media_score": 10,
    "fraud_score": 5
  },
  "pep_matches": [{
    "name": "John Smith",
    "country": "United States",
    "position": "Senator",
    "similarity": 0.92,
    "matchType": "strong"
  }],
  "adverse_media": {
    "articles_found": 2,
    "risk_keywords": ["investigation"],
    "score_contribution": 10
  },
  "fraud_signals": [{
    "type": "high_risk_country",
    "severity": "medium",
    "score": 5
  }],
  "reasons": [
    "PEP match found with 92% similarity",
    "Adverse media mentions detected"
  ],
  "screening_date": "2026-01-29T10:30:00Z"
}

POST /pep-search

Search the PEP database directly with fuzzy name matching.

{
  "name": "Vladimir Putin",
  "country": "Russia",
  "limit": 10
}

GET /pep-sources

List available PEP data sources with sync status and entry counts.

GET /health

Health check endpoint (no authentication required).

POST /risk-score-demo

Public demo endpoint — 10 requests/minute per IP, no authentication required.

Rate Limits

Plan	Monthly Quota	Per Minute
BASIC (Free)	100	10
PRO	3,000	60
ULTRA	10,000	120
MEGA	100,000	300

Rate limit headers are included in all responses:

X-RateLimit-Limit — Requests allowed in current period
X-RateLimit-Remaining — Requests remaining
X-RateLimit-Reset — ISO timestamp when limit resets

Error Codes

Code	Meaning
`400`	Bad Request — Invalid JSON or missing required fields
`401`	Unauthorized — Missing or invalid API key
`429`	Rate Limit Exceeded — Check `retry_after` field
`500`	Internal Server Error — Contact support if persistent

Support

Need help? Contact us:

Email: entityrisk@protonmail.com
Website: entityrisk.org