League: Moderation

Get league team bans

Changed on

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

Request

  • Base URL
    https://teambattles.gg/api/v1
  • URL
    https://teambattles.gg/api/v1/leagues/{identifier}/bans
  • Auth
    HTTP bearer

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