Team Completed Matches
Fetch completed match history for a team with scores, opponent info, win/loss status, and event context.
team.completed_matches(team_id) returns the completed match history for a team on vlr.gg.
Signature
team.completed_matches(team_id: int) -> TeamCompletedMatchesParameters
Prop
Type
Returns - TeamCompletedMatches
Prop
Type
TeamCompletedMatchEntry Fields
Prop
Type
OpponentInCompletedMatch Fields
Prop
Type
Examples
Recent results
Print the team's most recent completed matches with scores.
import vlrdevapi
history = vlrdevapi.team.completed_matches(team_id=624)
print(f"Completed matches for team {history.team_id}:")
for m in history.matches[:10]:
result = "WON" if m.is_win else "lost"
opp = m.opponent.name if m.opponent else "TBD"
print(f" {m.team_score} - {m.opponent_score} vs {opp} ({result}) - {m.event}")Win/loss record
Calculate and display the team's overall win/loss record.
import vlrdevapi
history = vlrdevapi.team.completed_matches(team_id=624)
wins = sum(1 for m in history.matches if m.is_win)
losses = sum(1 for m in history.matches if not m.is_win)
total = wins + losses
pct = wins / total * 100 if total else 0
print(f"{wins}W - {losses}L ({pct:.0f}% win rate) over {total} matches")Curried access
Access completed matches using the curried team() shorthand.
import vlrdevapi
team = vlrdevapi.team(624)
history = team.completed_matches()
for m in history.matches[:5]:
tag = m.opponent.tag if m.opponent else "TBD"
print(f"{'W' if m.is_win else 'L'} {m.team_score}-{m.opponent_score} vs {tag}")Last updated on