events.stages()
List available stage filters for an event
Signature
import vlrdevapi as vlr
stages = vlr.events.stages(
event_id: int,
timeout: float = 5.0,
) -> list[EventStage]Parameters
Prop
Type
Return Value
Type: list[EventStage]
Each item describes a selectable stage option from the matches page dropdown.
Prop
Type
Examples
List stages for an event
import vlrdevapi as vlr
stages = vlr.events.stages(event_id=2498)
for stage in stages:
print(f"{stage.series_id}: {stage.name} -> {stage.url}")Combine with events.matches()
import vlrdevapi as vlr
stages = vlr.events.stages(event_id=2498)
playoffs = next((s for s in stages if s.name.lower() == 'playoffs'), None)
if playoffs:
matches = vlr.events.matches(event_id=2498, stage=playoffs.name)
print(f"Found {len(matches)} matches in {playoffs.name}")
else:
print('Playoffs stage not available')Error Handling
- Network failures: Returns
[] - Invalid event ID: Returns
[] - No stage dropdown: Returns
[]