List ban reports and appeals
Pollable list of validated ban reports for the caller's delivered accounts, covering the whole lifecycle: appeal_pending (platform appeal filed, account unavailable but NOT yet banned), appeal_accepted (account survived), appeal_refused / no_appeal_banned (confirmed ban), and the staff commercial resolution (refund / remake / no_remake with a machine-readable reason_code such as tos_ban). While a report is appeal_pending, do NOT order a replacement account: a duplicate can trigger a ban-evasion strike on the platform, which is why TokPortal itself waits for the appeal. Key your reports on bundle_id — account_id can be null after a staff reset. A resolution of refund returns setup, warming and unused video slots, but not work already delivered and not the Coverage period, and the restored credits expire 60 days after restoration (see the credits.restored event in listWebhookEvents). This is the REST counterpart of the account.banned, account.ban_appeal.submitted, account.ban_appeal.resolved and account.ban_resolution.decided webhook events. Only staff/CM-validated bans appear here — detections from TokPortal's internal health scan are never listed. Poll with the since parameter (updated_at watermark) to pick up new reports and status changes.
Request
- Base URL: https://app.tokportal.com/api/ext
- URL: https://app.tokportal.com/api/ext/account-bans
- Auth: API key in header X-API-Key
Query parameters
Page number.
Items per page.
Filter by appeal lifecycle status.
Filter by staff commercial resolution. 'pending' selects confirmed bans still awaiting the staff decision.
Filter by saved account ID.
Only reports updated at or after this ISO 8601 timestamp. Use the highest updated_at you have seen as a polling watermark.
When true, each report includes a signed 7-day URL of the ban-evidence screenshot when one exists.
Response
Paginated ban report list.
Changes
No recorded changes to this operation across all 1 revision of this API.