teams.completed_matches()
Get a team's completed matches
Signature
import vlrdevapi as vlr
result = vlr.teams.completed_matches(
team_id: int,
limit: int | None = None,
timeout: float = 5.0
) -> list[TeamMatch]
Parameters
Prop
Type
Return Value
Type: list[TeamMatch]
Returns a list of completed matches with scores.
Prop
Type
Examples
Get Completed Matches
import vlrdevapi as vlr
# Get recent completed matches
matches = vlr.teams.completed_matches(team_id=799, limit=3)
print(f"Recent matches: {len(matches)}")
for match in matches:
score = f"{match.team1.score}-{match.team2.score}" if match.team1.score is not None else "N/A"
print(f"{match.tournament_name}")
print(f" {match.team1.name} {score} {match.team2.name}")
Analyze Win Rate
import vlrdevapi as vlr
matches = vlr.teams.completed_matches(team_id=799, limit=3)
team_info = vlr.teams.info(team_id=799)
if team_info:
team_name = team_info.name
wins = sum(1 for m in matches
if m.team1.score is not None and m.team2.score is not None
and ((m.team1.name == team_name and m.team1.score > m.team2.score)
or (m.team2.name == team_name and m.team2.score > m.team1.score)))
print(f"{team_name}: {wins} wins in last {len(matches)} matches")
Get Match Details
import vlrdevapi as vlr
matches = vlr.teams.completed_matches(team_id=799, limit=2)
for match in matches:
if match.match_id:
# Get detailed series info
series = vlr.series.info(match.match_id)
if series:
print(f"\n{series.event} - {series.event_phase}")
print(f"Score: {series.score[0]}-{series.score[1]}")
Error Handling
- Network failures: Returns an empty list
[]
- Invalid team ID: Returns an empty list
[]
- No completed matches: Returns an empty list
[]
The function never raises exceptions, making it safe to use without try-catch blocks.
Tips
- Check list length before accessing:
if matches:
- All optional fields can be
None
- check before using - Use
match_id
to get detailed match information withseries.info()
- Scores represent maps won, not rounds
- The
limit
parameter fetches across multiple pages if needed
Related
Source
Data scraped from: https://www.vlr.gg/team/matches/{team_id}?group=completed