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-scorepermission - 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
| Name | Type | Description |
|---|---|---|
| discordId | string | The 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
| Field | Type | Description |
|---|---|---|
| riskScore | number | Risk score from 0 to 100 (highest across linked profiles) |
| riskLevel | string | clean, low, medium, high, or critical |
| linkedProfiles | number | Number of risk profiles linked to this Discord user |
| stats | object | Aggregated scan statistics across all linked profiles |
| uniqueCheatsDetected | array | List of unique cheat names detected across all scans |
| isBanned | boolean | Whether any linked profile is currently banned |
Risk Levels
| Level | Score Range | Description |
|---|---|---|
clean | 0 | No detections or suspicious activity |
low | 1 - 25 | Minor flags, likely false positives |
medium | 26 - 50 | Some suspicious activity detected |
high | 51 - 75 | Multiple detections, likely cheating |
critical | 76 - 100 | Confirmed 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);
}