List recorded bans
/api/audit/bansBans 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.
An API key, made on Settings, API keys. Every key starts with mbk_.
In: header
Query Parameters
int32int32Response 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 }}Get audit log filters GET
The type list is already narrowed to the caller's permissions, so the SPA offers only what the server would answer. The actor list is the recent actors in the visible history — a filter control, deliberately not a member list.
List case files GET
Case files, newest first -- everyone's, or one person's. Withdrawn case files are left out unless includeWithdrawn is true. Nothing is ever deleted, so a withdrawn one is still there to read; it just no longer counts as the write-up of its ban. Needs the `ViewProfile` permission.