Event Teams

event.teams(event_id) returns the teams participating in an event, grouped by stage. When the event has multiple stages, team data is fetched in parallel (up to 5 concurrent requests) for optimal performance.

Signature

event.teams(
    event_id: int,
    stage: str | None = None,
) -> EventTeams

Parameters

Returns - EventTeams

EventTeams wraps a list of EventStageTeams and supports __len__, __iter__, __getitem__.

EventStageTeams Fields

Team 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 (single-stage or simple events), all teams are returned under a single "All Teams" stage.
• Parallel fetching uses up to 5 concurrent workers.

Examples

All teams grouped by stage

Fetch all teams across every stage. The result is organized as a list of EventStageTeams, each containing a stage_name and a list of Team objects. This structure makes it easy to understand which teams are competing in which stage.

import vlrdevapi

teams = vlrdevapi.event(2765).teams()
for stage_teams in teams:
    print(f"--- {stage_teams.stage_name} ---")
    for team in stage_teams.teams:
        print(f"  {team.name} (ID: {team.id})")

Teams with notes

Some teams have additional annotations attached to them, such as "Partner Team" or "Invited". Use the note field to surface this extra context when displaying team information.

import vlrdevapi

teams = vlrdevapi.event(2765).teams()
for stage_teams in teams:
    print(f"--- {stage_teams.stage_name} ---")
    for team in stage_teams.teams:
        note = f" - {team.note}" if team.note else ""
        print(f"  {team.name}{note}")

Filter teams by stage

Pass the stage parameter to restrict results to a specific stage. The parameter accepts stage path names such as "playoffs" or "group-stage". This is useful when you only need teams from a particular phase of the tournament.

import vlrdevapi

playoff_teams = vlrdevapi.event(2765).teams(stage="playoffs")
for stage_teams in playoff_teams:
    print(f"Stage: {stage_teams.stage_name}")
    for team in stage_teams.teams:
        print(f"  {team.name}")

Count teams per stage

Use len() on each stage's team list to quickly determine the number of participating teams per stage. This can help identify which stages have the most competitors.

import vlrdevapi

teams = vlrdevapi.event(2765).teams()
for stage_teams in teams:
    count = len(stage_teams.teams)
    print(f"{stage_teams.stage_name}: {count} teams")