Accounts

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.

get/account-bans

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

pageinteger

Page number.

per_pageinteger

Items per page.

status'appeal_pending' | 'appeal_accepted' | 'appeal_refused' | 'no_appeal_banned'

Filter by appeal lifecycle status.

resolution'refund' | 'remake' | 'no_remake' | 'pending'

Filter by staff commercial resolution. 'pending' selects confirmed bans still awaiting the staff decision.

account_idstring uuid

Filter by saved account ID.

sincestring date-time

Only reports updated at or after this ISO 8601 timestamp. Use the highest updated_at you have seen as a polling watermark.

include_screenshots'true' | 'false'

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.