GET
/
v1
/
device
/
{device_id}
/
bans
/
social
List Social Bans
curl --request GET \
  --url https://api.sentineltrustplay.io/v1/device/{device_id}/bans/social \
  --header 'Authorization: <authorization>' \
  --header 'X-Game-Id: <x-game-id>'
{
  "device_id": "dvc_abc123",
  "status": "active",
  "counts": {
    "active": 1,
    "inactive": 0,
    "total": 1
  },
  "items": [
    {
      "ban_id": 5,
      "ban_type": "social",
      "scope": "publisher",
      "publisher_id": "pub_acme",
      "game_id": null,
      "reason_code": "harassment",
      "details_json": null,
      "created_at": "2025-06-20T14:00:00Z",
      "expires_at": "2025-07-20T14:00:00Z",
      "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": 1,
    "inactive": 0,
    "total": 1
  },
  "items": [
    {
      "ban_id": 5,
      "ban_type": "social",
      "scope": "publisher",
      "publisher_id": "pub_acme",
      "game_id": null,
      "reason_code": "harassment",
      "details_json": null,
      "created_at": "2025-06-20T14:00:00Z",
      "expires_at": "2025-07-20T14:00:00Z",
      "revoked_at": null
    }
  ]
}