Event Standings

event.standings(event_id) returns the standings for an event, grouped by stage. Multi-stage events are fetched in parallel (up to 5 concurrent requests) for optimal performance.

Signature

event.standings(
    event_id: int,
    stage: str | None = None,
) -> EventStandings

Parameters

Returns - EventStandings

EventStandings wraps a list of EventStageStandings and supports __len__, __iter__, __getitem__.

EventStageStandings Fields

StandingEntry Fields

TeamStanding Fields

Behaviour

• Stages are parsed from the event page sub-navigation.
• When stage is provided, only matching stages are fetched.
• If no subnav is detected, all standings are returned under a single "All Stages" entry.
• Parallel fetching uses up to 5 concurrent workers.

Examples

All standings grouped by stage

Fetch standings for the entire event organized by stage. Each stage contains a list of StandingEntry objects ordered by placement, with place strings like "1st", "2nd", "3rd-4th", etc.

import vlrdevapi

standings = vlrdevapi.event(2765).standings()
for stage_standing in standings:
    print(f"--- {stage_standing.stage_name} ---")
    for entry in stage_standing.standings:
        print(f"  {entry.place}: {entry.team.name}")

Standings with prize money

Each standing entry includes prize information via prize_money (numeric value) and prize_currency (symbol). Format them together to display prize amounts. The prize_money value is an integer that can be formatted with commas using Python's format specifier.

import vlrdevapi

standings = vlrdevapi.event(2765).standings()
for stage_standing in standings:
    print(f"--- {stage_standing.stage_name} ---")
    for entry in stage_standing.standings:
        prize = f"{entry.prize_currency}{entry.prize_money:,}" if entry.prize_money and entry.prize_currency else "(no prize)"
        print(f"  {entry.place}: {entry.team.name} - {prize}")

Filter standings by stage

Pass the stage parameter to retrieve standings for a specific stage only. This is useful for building focused views, such as showing only the group stage standings on a group stage page.

import vlrdevapi

standings = vlrdevapi.event(2765).standings(stage="swiss-stage")
top_entry = standings[0].standings[0]
print(f"1st: {top_entry.team.name} ({top_entry.team.country})")
print(f"Points: {top_entry.points}")
print(f"Note: {top_entry.note}")

Access team details from standings

Each StandingEntry contains a TeamStanding object with detailed team information. You can access the team's name, country of origin, and logo URL directly from the standing entries without making additional API calls.

import vlrdevapi

standings = vlrdevapi.event(2765).standings()
for stage_standing in standings:
    for entry in stage_standing.standings:
        team = entry.team
        print(f"{entry.place}: {team.name}")
        print(f"  Country: {team.country}")
        print(f"  Logo: {team.logo_url}")