matches.upcoming()

import vlrdevapi as vlr

result = vlr.matches.upcoming(
    limit: int | None = None,
    page: int | None = None,
    timeout: float = 5.0
) -> list[Match]

import vlrdevapi as vlr

# Get next 5 upcoming matches
matches = vlr.matches.upcoming(limit=5)

for m in matches:
    print(f"{m.event} - {m.event_phase}")
    print(f"  {m.team1.name} vs {m.team2.name}")
    print(f"  Time: {m.time}")
    
    # Team IDs can be None for TBD teams
    if m.team1.id and m.team2.id:
        print(f"  IDs: {m.team1.id} vs {m.team2.id}")

import vlrdevapi as vlr

# Get page 2 of upcoming matches
matches = vlr.matches.upcoming(page=2)

print(f"Found {len(matches)} matches on page 2")
for m in matches:
    print(f"{m.team1.name} vs {m.team2.name} - {m.time}")
    if m.date:
        print(f"  Date: {m.date}")

import vlrdevapi as vlr

# Get all upcoming matches and filter
matches = vlr.matches.upcoming(limit=50)

# Filter for specific event
vct_matches = [m for m in matches if "VCT" in m.event]

print(f"VCT matches: {len(vct_matches)}")
for m in vct_matches:
    print(f"{m.event}: {m.team1.name} vs {m.team2.name}")