Skip to main content

Scanned Users API

GET /v1/scanned-users/lookup/:discordId

The Scanned Users API allows you to query complete user information including scan history, detections, ban/warn status, and related accounts.

Base URL
https://api.anticheat.ac/v1
Authentication
API Key required with scanned-users:lookup permission
Requires
Active license or enterprise membership

Lookup User by Discord ID

Retrieve complete information about a Discord user including their scan history, detections, ban/warn status, and potentially related accounts.

GET/v1/scanned-users/lookup/:discordId

Parameters

NameTypeDescription
discordIdstringThe Discord user ID to lookup

Headers

x-api-key: your_api_key_here

Response

{
  "found": true,
  "discordId": "123456789012345678",
  "username": "PlayerUsername",
  "totalScans": 5,
  "totalDetections": 3,
  "overallStatus": "cheating",
  "isBanned": true,
  "isWarned": false,
  "bans": [
    {
      "status": "banned",
      "reason": "Cheating detected - Generic Loader",
      "isExpired": false,
      "createdAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "detections": [
    "Generic Cheat Loader - Detection",
    "Process Injection - FiveM.exe"
  ],
  "reasons": [
    {
      "reason": "⚠️ Possible alt account detected: AltAccount (987654321)",
      "category": "suspicious",
      "addedAt": "2024-01-15T10:30:00.000Z",
      "evidence": null
    }
  ],
  "firstSeen": "2024-01-10T08:00:00.000Z",
  "lastSeen": "2024-01-20T15:45:00.000Z",
  "gamesScanned": ["Java", "FiveM"],
  "totalHwids": 2,
  "hasRelatedAccounts": true,
  "totalRelatedAccounts": 1,
  "relatedAccounts": [
    {
      "discordId": "987654321098765432",
      "username": "AltAccount",
      "sharedHwidIds": [1],
      "totalDetections": 5,
      "overallStatus": "cheating",
      "lastSeenAt": "2024-01-18T12:00:00.000Z",
      "detections": [
        "System Hooking - svchost.exe",
        "Generic Packed File - cheat.exe"
      ]
    }
  ]
}

Response Fields

FieldTypeDescription
foundbooleanIndicates if the user was found in the database
discordIdstringThe Discord user ID
usernamestringCurrent username
totalScansnumberTotal number of scans performed on this user
totalDetectionsnumberTotal number of detections found
overallStatusstringOverall status: clean, suspicious, cheating, or banned
isBannedbooleanWhether any linked HWID is currently banned
isWarnedbooleanWhether any linked HWID has an active warning
bansarrayList of active bans/warnings with status, reason, expiry, and creation date
detectionsarrayList of all unique detections found
reasonsarrayManual reasons/notes added by staff or automatically by the system
firstSeenstringISO 8601 timestamp of the first scan
lastSeenstringISO 8601 timestamp of the last scan
gamesScannedarrayList of games the user has been scanned in (e.g. Java, FiveM, Bedrock)
totalHwidsnumberNumber of unique HWIDs linked to this user
hasRelatedAccountsbooleanIndicates if potentially related accounts were detected
totalRelatedAccountsnumberNumber of related accounts detected
relatedAccountsarrayList of potentially related accounts detected by Ocean's multi-accounting detection systems

Bans Object

FieldTypeDescription
statusstringbanned, warned, or expired
reasonstringReason for the ban or warning
isExpiredbooleanWhether the ban/warning has expired
createdAtstringISO 8601 timestamp when the ban/warning was created

Related Accounts Object

FieldTypeDescription
discordIdstringDiscord ID of the related account
usernamestringUsername of the related account
sharedHwidIdsarrayIDs of the shared HWIDs linking the accounts
totalDetectionsnumberTotal detections on the related account
overallStatusstringStatus of the related account
lastSeenAtstringLast time this related account was scanned
detectionsarrayDetections found on the related account

User Not Found Response

When a user is not found in the database, the API returns the following response:

{
  "found": false,
  "discordId": "123456789012345678",
  "message": "User not found in scan database",
  "relatedAccounts": []
}

Security & Privacy

Multi-Account Detection

Ocean uses advanced detection systems to identify potentially related accounts. When connections between accounts are detected, they are automatically linked and notes are added to their profiles in real-time during the scan process.

Privacy Protection

Sensitive detection methods and technical identifiers (HWIDs, IPs) are never exposed through the API to protect user privacy and maintain the integrity of our detection systems.

Example Usage

cURL

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

JavaScript/Node.js

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

const data = await response.json();

if (data.found) {
  console.log('Status:', data.overallStatus);
  console.log('Banned:', data.isBanned);
  console.log('Detections:', data.detections.length);
  console.log('Related accounts:', data.totalRelatedAccounts);
}

Python

import requests

headers = {
    'x-api-key': 'your_api_key_here'
}

response = requests.get(
    'https://api.anticheat.ac/v1/scanned-users/lookup/123456789012345678',
    headers=headers
)

data = response.json()

if data['found']:
    print(f"Status: {data['overallStatus']}")
    print(f"Banned: {data['isBanned']}")
    print(f"Games: {', '.join(data['gamesScanned'])}")

Rate Limiting

API requests are rate-limited to ensure fair usage and system stability. The current global rate limit is:

Global Rate Limit

1,000 requests per hour per API key

If you need higher rate limits for your integration, please contact our support team.

Rate limit headers are included in every response:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200