Skip to main content
GET
/
leaderboards
/
teams
/
{identifier}
/
rank
Get a team's leaderboard rank
curl --request GET \
  --url https://teambattles.gg/api/v1/leaderboards/teams/{identifier}/rank \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "rank": 4503599627370495,
  "timestamp": "<string>",
  "gameSlug": "<string>"
}

Authorizations

Authorization
string
header
required

Send your API key as: Authorization: Bearer tb_

Path Parameters

identifier
string
required

Team slug or Convex team ID.

Query Parameters

sortBy
enum<string>

Supported leaderboard sort field.

Available options:
wins,
winRate,
experience
gameSlug
string

Response

Team rank.

Leaderboard rank lookup response.

id
string
required

Resolved entity ID.

rank
integer | null
required
Required range: 0 < x <= 9007199254740991
sortBy
enum<string>
required

Supported leaderboard sort field.

Available options:
wins,
winRate,
experience
timestamp
string
required
gameSlug
string | null