Pins API
GET /v1/pins/:pinCode/results
The Pins API allows you to retrieve scan results for your own pins programmatically. Useful for building Discord bots, automation tools, and custom integrations. To track scan progress in real-time, see the Pin Status API.
- Base URL
https://api.anticheat.ac/v1- Authentication
- API Key required with
pins:resultspermission
Get Pin Results
Retrieve the scan results for a specific pin. You can only access results for pins that you own (created by your account). Returns detection data including detections, suspicious items, warnings, integrity checks, and basic scan metadata.
GET/v1/pins/:pinCode/results
Parameters
| Name | Type | Description |
|---|---|---|
| pinCode | string | The 8-character pin code (e.g. A7K3M2P9P9) |
Headers
x-api-key: your_api_key_here
Response (Finished Scan)
{
"pin": "A7K3M2P9P9",
"type": "Java",
"status": "finished",
"result": "cheating",
"pinName": "Tournament Match #42",
"data": {
"cheating": "cheating",
"detections": [
"Generic Cheat Loader - Detection",
"Process Injection - javaw.exe"
],
"suspicious": [
"Modified game files detected"
],
"warnings": [
"Multiple Minecraft instances detected"
],
"untrusted": [],
"integrity": [
"System file tampered: kernel32.dll"
],
"customSuspicious": [],
"vpn": "No",
"country": "US",
"logon": "2h 30m",
"scantime": "45 seconds",
"windows": "Windows 11 Pro 23H2",
"discord": [
{ "id": "123456789012345678", "username": "player123" }
]
},
"createdAt": "2024-01-15T10:30:00.000Z"
}Response (Pending/In Progress)
{
"pin": "A7K3M2P9",
"type": "Java",
"status": "pending",
"result": "none",
"pinName": "Tournament Match #42",
"message": "Pin is waiting for scan to start"
}Error Responses
| Status | Code | Description |
|---|---|---|
400 | Bad Request | Pin code is empty or invalid |
403 | Forbidden | The pin does not belong to your account |
404 | Not Found | Pin code does not exist |
Data Fields
| Field | Type | Description |
|---|---|---|
| cheating | string | null | Overall cheating verdict |
| detections | array | List of confirmed cheat detections |
| suspicious | array | List of suspicious findings |
| warnings | array | List of warning flags |
| untrusted | array | List of untrusted items |
| integrity | array | List of integrity check results |
| customSuspicious | array | Custom suspicious detections from your configured keywords |
| vpn | string | null | VPN detection status |
| country | string | null | Country of the scanned user |
| logon | string | null | System logon/uptime duration |
| scantime | string | null | How long the scan took |
| windows | string | null | Windows version information |
| discord | array | Discord accounts detected on the scanned system. Each entry has id (Discord user ID) and username |
Ownership Required
You can only retrieve results for pins created by your own account. Attempting to access another user's pin will return a 403 Forbidden error.
Privacy Protection
Sensitive information such as HWID, server IP, alt accounts, and internal identifiers are never exposed through this endpoint to protect user privacy.
Pin Statuses
| Status | Description |
|---|---|
pending | Pin created, waiting for the scan to start |
scanning | Scan is currently in progress |
finished | Scan completed, results available |
expired | Pin expired before scan was completed |
error | An error occurred during scanning |
Example Usage
cURL
curl -X GET "https://api.anticheat.ac/v1/pins/A7K3M2P9/results" \ -H "x-api-key: your_api_key_here"
JavaScript / Node.js
const response = await fetch('https://api.anticheat.ac/v1/pins/A7K3M2P9/results', {
headers: { 'x-api-key': 'your_api_key_here' }
});
const data = await response.json();
if (data.status === 'finished') {
console.log('Result:', data.result);
console.log('Detections:', data.data.detections);
console.log('Suspicious:', data.data.suspicious);
} else {
console.log('Status:', data.status, '-', data.message);
}Python
import requests
response = requests.get(
'https://api.anticheat.ac/v1/pins/A7K3M2P9/results',
headers={'x-api-key': 'your_api_key_here'}
)
data = response.json()
if data['status'] == 'finished':
print(f"Result: {data['result']}")
print(f"Detections: {data['data']['detections']}")
else:
print(f"Status: {data['status']} - {data.get('message', '')}")Poll Until Finished (JavaScript)
async function waitForResults(pinCode, apiKey) {
const url = 'https://api.anticheat.ac/v1/pins/' + pinCode + '/results';
const headers = { 'x-api-key': apiKey };
while (true) {
const res = await fetch(url, { headers });
const data = await res.json();
if (data.status === 'finished') return data;
if (data.status === 'expired' || data.status === 'error') {
throw new Error('Scan ' + data.status + ': ' + (data.message || ''));
}
await new Promise(r => setTimeout(r, 5000));
}
}
const results = await waitForResults('A7K3M2P9', 'your_api_key_here');
console.log(results.data);