Skip to main content

User Risk Score API

GET /v1/users/:discordId/risk-score

Retrieve the calculated risk score for a Discord user. The risk score aggregates scan history, detections, and behavioral analysis across all linked profiles.

Base URL
https://api.anticheat.ac/v1
Authentication
API Key required with user:risk-score permission
Requires
Active license or enterprise membership

Get Risk Score by Discord ID

Returns the highest risk score found across all profiles linked to the Discord user, along with aggregated scan statistics.

GET/v1/users/:discordId/risk-score

Parameters

NameTypeDescription
discordIdstringThe Discord user ID to query

Headers

x-api-key: your_api_key_here

Response

{
  "found": true,
  "discordId": "123456789012345678",
  "riskScore": 78,
  "riskLevel": "high",
  "linkedProfiles": 2,
  "stats": {
    "totalScans": 12,
    "cheatingScans": 4,
    "suspiciousScans": 3,
    "cleanScans": 5,
    "totalDetections": 15
  },
  "uniqueCheatsDetected": [
    "Generic Cheat Loader",
    "Process Injection",
    "Memory Manipulation"
  ],
  "isBanned": false,
  "firstScanDate": "2024-01-10T08:00:00.000Z",
  "lastScanDate": "2024-02-01T14:30:00.000Z",
  "lastCheatingDate": "2024-01-28T12:00:00.000Z"
}

Response Fields

FieldTypeDescription
riskScorenumberRisk score from 0 to 100 (highest across linked profiles)
riskLevelstringclean, low, medium, high, or critical
linkedProfilesnumberNumber of risk profiles linked to this Discord user
statsobjectAggregated scan statistics across all linked profiles
uniqueCheatsDetectedarrayList of unique cheat names detected across all scans
isBannedbooleanWhether any linked profile is currently banned

Risk Levels

LevelScore RangeDescription
clean0No detections or suspicious activity
low1 - 25Minor flags, likely false positives
medium26 - 50Some suspicious activity detected
high51 - 75Multiple detections, likely cheating
critical76 - 100Confirmed cheating with extensive detection history

Example Usage

cURL

curl -X GET "https://api.anticheat.ac/v1/users/123456789012345678/risk-score" \
  -H "x-api-key: your_api_key_here"

JavaScript/Node.js

const response = await fetch(
  'https://api.anticheat.ac/v1/users/123456789012345678/risk-score',
  { headers: { 'x-api-key': 'your_api_key_here' } }
);

const data = await response.json();

if (data.riskScore >= 75) {
  console.log('High risk user! Level:', data.riskLevel);
}