Skip to main content
POST
/
leagues
/
{identifier}
/
standings
curl -X POST https://teambattles.gg/api/v1/leagues/my-league/standings \
  -H "Authorization: Bearer tb_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"limit": 50}'

{
  "standings": [
    {}
  ],
  "count": 123,
  "timestamp": "2023-11-07T05:31:56Z"
}
curl -X POST https://teambattles.gg/api/v1/leagues/my-league/standings \
  -H "Authorization: Bearer tb_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"limit": 50}'

​
Permission Required

This endpoint requires the leagues.league_public permission on your API key.

​
League Identifier

The {identifier} path parameter accepts the league slug - the URL-friendly league name (e.g., my-league).

​
What’s Returned

Returns standings (approved teams with stats) for a specific league. Each team includes a rank field based on their position in the standings. Results are sorted by performance and only include teams with an APPROVED status.

​
Request Body

ParameterTypeRequiredDescription
seasonIdstringNoFilter standings by a specific season ID
gameIdstringNoFilter standings by a specific game ID
limitnumberNoMaximum results to return (1-100, default 50)

​
Filtering Options

​
Season Filtering

Use the seasonId parameter to get standings for a specific season. If omitted, returns overall standings.

​
Game Filtering

Use gameId to filter standings to teams competing in a specific game.

​
Common Use Cases

​
Get Overall Standings

{
	"limit": 50
}

​
Get Season-Specific Standings

{
	"seasonId": "jh7abc123def456",
	"limit": 100
}

​
Get Standings for a Specific Game

{
	"gameId": "call_of_duty",
	"limit": 25
}

​
Get Top 10 Teams

{
	"limit": 10
}

Authorizations

​
Authorization
string
header
required

API key authentication. Generate an API key from Settings > Developer in the TeamBattles app. Format: tb_xxxxxxxx...

Path Parameters

​
identifier
string
required

League slug

Body

application/json

Optional season, game filter, and limit

​
seasonId
string

Filter standings by a specific season ID

​
gameId
string

Filter standings by a specific game ID

​
limit
integer
default:50

Maximum number of teams to return (1-100)

Required range: 1 <= x <= 100

Response

Successful response

​
standings
object[]
​
count
integer

Number of teams returned

​
timestamp
string<date-time>

Response timestamp (ISO 8601)