VLRdevAPI

Team Upcoming Matches

Fetch upcoming matches for a team with opponent details, event context, and scheduled datetime.

team.upcoming_matches(team_id) returns the upcoming matches for a team on vlr.gg.

Signature

team.upcoming_matches(team_id: int) -> TeamUpcomingMatches

Parameters

Prop

Type

Returns - TeamUpcomingMatches

Prop

Type

TeamUpcomingMatchEntry Fields

Prop

Type

OpponentInUpcomingMatch Fields

Prop

Type

Examples

List upcoming matches

Print all upcoming matches with opponent and event details.

import vlrdevapi

upcoming = vlrdevapi.team.upcoming_matches(team_id=624)
if not upcoming.matches:
    print("No upcoming matches for Paper Rex")
for m in upcoming.matches:
    opp = m.opponent.name if m.opponent else "TBD"
    print(f"vs {opp} ({m.event} - {m.stage}) at {m.datetime}")

Check for upcoming matches in a specific event

Filter upcoming matches to a specific event.

import vlrdevapi

upcoming = vlrdevapi.team.upcoming_matches(team_id=624)
vct = [m for m in upcoming.matches if "vct" in m.event.lower()]
if vct:
    for m in vct:
        opp = m.opponent.name if m.opponent else "TBD"
        print(f"VCT match vs {opp} on {m.datetime}")
else:
    print("No upcoming VCT matches")

Curried access

Access upcoming matches using the curried team() shorthand.

import vlrdevapi

team = vlrdevapi.team(624)
upcoming = team.upcoming_matches()
if not upcoming.matches:
    print("No upcoming matches")
for m in upcoming.matches:
    opp = m.opponent.tag if m.opponent else "?"
    print(f"Next: vs {opp} at {m.event}")

Last updated on

On this page