GET
/
v1
/
device
/
{device_id}
/
bans
/
cheat
List Cheat Bans
curl --request GET \
  --url https://api.sentineltrustplay.io/v1/device/{device_id}/bans/cheat \
  --header 'Authorization: <authorization>' \
  --header 'X-Game-Id: <x-game-id>'
{
  "device_id": "dvc_abc123",
  "status": "active",
  "counts": {
    "active": 2,
    "inactive": 1,
    "total": 3
  },
  "items": [
    {
      "ban_id": 3,
      "ban_type": "cheat",
      "scope": "game",
      "publisher_id": "pub_acme",
      "game_id": "game_fps_01",
      "reason_code": "aimbot",
      "details_json": "{\"confidence\": 0.95}",
      "created_at": "2025-06-15T10:30:00Z",
      "expires_at": null,
      "revoked_at": null
    }
  ]
}
​
Authorization
string
required
API key as Bearer token: Bearer sni_<your-key>. Sent by client.
​
X-Game-Id
string
required
Game identifier. Sent by client.
​
device_id
string
required
The device ID to list bans for.
​
status
string
default:"active"
Filter by ban status: active, inactive, or all.
​
limit
integer
default:50
Maximum number of bans to return (1–200).
​
cursor
integer
Ban ID cursor for keyset pagination. Returns bans with ban_id < cursor.
{
  "device_id": "dvc_abc123",
  "status": "active",
  "counts": {
    "active": 2,
    "inactive": 1,
    "total": 3
  },
  "items": [
    {
      "ban_id": 3,
      "ban_type": "cheat",
      "scope": "game",
      "publisher_id": "pub_acme",
      "game_id": "game_fps_01",
      "reason_code": "aimbot",
      "details_json": "{\"confidence\": 0.95}",
      "created_at": "2025-06-15T10:30:00Z",
      "expires_at": null,
      "revoked_at": null
    }
  ]
}