Upcoming Matches

matches.upcoming() returns a paginated list of upcoming matches from vlr.gg, with support for fetching multiple pages.

Signature

matches.upcoming(
    page: int = 1,
    max_page: int = 0,
    return_all: bool = False,
) -> UpcomingMatchesPage

Parameters

Prop

Type

Returns - `UpcomingMatchesPage`

Prop

Type

`UpcomingMatchEntry` Fields

Prop

Type

`TeamInUpcomingMatch` Fields

Prop

Type

Examples

Single page of upcoming matches

Fetch the first page of upcoming matches and display basic info.

import vlrdevapi

results = vlrdevapi.matches.upcoming(page=1)
print(f"Matches on this page: {len(results.matches)}")
print(f"More pages available: {results.has_next_page}")

for match in results.matches:
    t1 = match.team1.name if match.team1 else "TBD"
    t2 = match.team2.name if match.team2 else "TBD"
    print(f"{t1} vs {t2} [{match.stage}] - {match.eta}")

Fetch all upcoming matches

Use return_all=True to automatically paginate through all available pages.

import vlrdevapi

results = vlrdevapi.matches.upcoming(return_all=True)
print(f"Total upcoming matches: {len(results.matches)}")

for match in results.matches:
    t1 = match.team1.name if match.team1 else "TBD"
    t2 = match.team2.name if match.team2 else "TBD"
    print(f"{t1} vs {t2} | {match.event} | {match.datetime}")

Filter by event

Upcoming matches include event context, so you can filter programmatically.

import vlrdevapi

results = vlrdevapi.matches.upcoming(return_all=True)
vct_matches = [m for m in results.matches if "VCT" in m.event]
for m in vct_matches:
    t1 = m.team1.name if m.team1 else "TBD"
    t2 = m.team2.name if m.team2 else "TBD"
    print(f"{t1} vs {t2} - {m.stage} ({m.eta})")

On this page