Modbot Docs

List recorded bans

GET/api/audit/bans

Bans Modbot has recorded — not the group's ban list. Derived from ban and unban facts, which come from VRChat's group audit log. It therefore covers the period since this deployment first synced, bounded by whatever VRChat's own audit-log retention still held at that moment — a group with three years of bans and a week-old Modbot has a week of them here.

coverage carries that window and callers must show it. A full ban list needs a sweep of groups.bans, which is not built.

Needs the ViewAuditLog permission.

AuthorizationBearer <token>

An API key, made on Settings, API keys. Every key starts with mbk_.

In: header

Query Parameters

offset?integer
Formatint32
limit?integer
Formatint32
includeUnbanned?boolean

Response Body

application/json

application/problem+json

application/problem+json

curl -X GET "https://example.com/api/audit/bans"
{  "bans": [    {      "subjectPlatform": "string",      "subjectId": "string",      "status": "string",      "bannedAt": null,      "bannedBefore": null,      "unbannedAt": null,      "actorPlatform": null,      "actorId": null,      "actorName": null,      "description": null,      "source": null    }  ],  "total": 0,  "offset": 0,  "coverage": {    "earliestRecord": null,    "latestRecord": null,    "firstSyncedAt": null,    "catchUpComplete": true,    "lastPolledAt": null,    "bannedCount": 0,    "unbannedCount": 0  }}

Modbot is not endorsed by or affiliated with VRChat Inc. or Discord Inc. VRChat is a trademark of VRChat Inc. Discord is a trademark of Discord Inc. SteamVR is a trademark of Valve Corporation. Windows is a trademark of Microsoft Corporation. Docker is a trademark of Docker, Inc. PostgreSQL is a trademark of the PostgreSQL Community Association of Canada. Railway is a trademark of Railway Corp. Other names are trademarks of their respective owners; see Legal. Modbot and its logo are trademarks of the Modbot project. Open source under AGPL-3.0.