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}")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.
Related
Source
Data scraped from: https://www.vlr.gg/team/matches/{team_id}?group=completed