League: Moderation

Get league team bans

Returns team bans for a league resolved by slug, with optional status filtering. Requires a personal or developer API key whose owner is currently a league ADMIN of the league in the path (or TeamBattles staff), with leagues.league_admin:read access on the key. These admin reads no longer require a paid developer plan; they stay authority-gated (current league ADMIN) and rate-limited by the league owner's plan. League API WRITE routes still require the leagueOperatorApi feature (api_pro or higher) on the league owner's plan.

post/leagues/{identifier}/bans

Path parameters

identifierstring required

League slug.

Request body

status'active' | 'expired' | 'revoked' | 'all'

Filter bans by computed status. Defaults to all.

Response

Team bans for the league.

bansobject[] required

Enriched team ban records with computed status.

countinteger required

Number of bans returned.

timestampstring required

Response generation time (ISO 8601).

Changes

Changed in 2 of the 21 revisions of this API.4

Jun 10, 202682f2480cdb832See the full diff
- ○
  api tag League: Moderation added
  api-tag-added
- ○
  api tag Leagues removed
  api-tag-removed
Jun 4, 2026f22bd61fd5952See the full diff
- ○
  api tag Leagues added
  api-tag-added
- ○
  api tag League: Moderation removed
  api-tag-removed
This revision also has 377 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history