VlrDevApi

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

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

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.

Source

Data scraped from: https://www.vlr.gg/team/matches/{team_id}?group=completed