Event Stages

event.stages(event_id) returns the stage breakdown for an event (e.g. "Group Stage", "Playoffs") with start/end dates inferred from the event page subnav.

Signature

event.stages(event_id: int) -> EventStages

Parameters

Returns - EventStages

EventStages wraps a list of EventStage objects and supports __len__, __iter__, and __getitem__.

Container Protocol

EventStage Fields

Behaviour

• Stages are parsed from the event's matches page, not the main event page.
• If the matches page has stages, an additional fetch to the main event page is made to extract date ranges from the sub-navigation.
• The id field can be passed as the stage_id parameter to event(id).matches() to filter matches by stage.

Examples

List all stages

Fetch all stages for an event and print their display names along with their internal stage IDs. The id field is the value used in the series_id URL parameter when filtering matches.

import vlrdevapi

stages = vlrdevapi.event(2765).stages()
print(f"Found {len(stages)} stages")

for stage in stages:
    print(f"  {stage.name} (ID: {stage.id})")

Stages with dates

Each stage may have inferred start and end dates extracted from the event page's sub-navigation date ranges. These dates are datetime.date objects when available, or None if they could not be determined.

import vlrdevapi

stages = vlrdevapi.event(2765).stages()
for stage in stages:
    start = stage.start_date or "TBD"
    end = stage.end_date or "TBD"
    print(f"{stage.name}: {start} to {end}")

Access by index

The EventStages object supports direct indexing and slicing, making it easy to access specific stages without iteration.

import vlrdevapi

stages = vlrdevapi.event(2765).stages()
first_stage = stages[0]
print(f"First stage: {first_stage.name}")

last_stage = stages[-1]
print(f"Last stage: {last_stage.name}")

Use stage ID to filter matches

The id field from each stage can be passed directly to the matches() method as the stage_id parameter. This allows you to fetch matches for a specific stage of the event.

import vlrdevapi

stages = vlrdevapi.event(2765).stages()
for stage in stages:
    stage_matches = vlrdevapi.event(2765).matches(stage_id=stage.id)
    print(f"{stage.name}: {len(stage_matches.matches)} matches")