v20

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB

League: Moderation

Get league penalties and cooldowns

Returns penalties and/or member cooldowns for a league resolved by slug, with optional 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}/penalties

Path parameters

identifierstring required

League slug.

Request body

type'penalties' | 'cooldowns' | 'all'

Which record kinds to return. Defaults to all.

teamIdstring

Filter penalties to a specific team id.

gameIdstring

Filter penalties to a specific game id.

limitinteger

Maximum number of penalties to return (1-100). Defaults to 50.

Response

Penalties and cooldowns for the league.

penaltiesobject[] required

Enriched penalty records (empty when type is cooldowns).

cooldownsobject[] required

Enriched member cooldown records (empty when type is penalties).

countinteger required

Combined number of penalties and cooldowns returned.

timestampstring required

Response generation time (ISO 8601).