Completed Matches

Browse completed matches on vlr.gg with scores, winner info, pagination, and multi-page support.

matches.completed() returns a paginated list of completed matches from vlr.gg, including scores and winner information.

Signature

matches.completed(
    page: int = 1,
    max_page: int = 0,
    return_all: bool = False,
) -> CompletedMatchesPage

Parameters

Prop

Type

Returns - `CompletedMatchesPage`

Prop

Type

`CompletedMatchEntry` Fields

Prop

Type

`TeamInCompletedMatch` Fields

Prop

Type

Examples

Single page of completed matches

Fetch the first page of completed matches and display scores with the winner.

import vlrdevapi

results = vlrdevapi.matches.completed(page=1)
print(f"Matches on this page: {len(results.matches)}")
print(f"More pages available: {results.has_next_page}")

for match in results.matches:
    t1 = match.team1
    t2 = match.team2
    winner = t1.name if t1 and t1.is_winner else (t2.name if t2 else "N/A")
    print(f"{t1.name if t1 else 'TBD'} {t1.score if t1 else '?'} - {t2.score if t2 else '?'} {t2.name if t2 else 'TBD'} | Winner: {winner}")

Fetch all completed matches

Use return_all=True to paginate through all available pages and collect every completed match.

import vlrdevapi

results = vlrdevapi.matches.completed(return_all=True)
print(f"Total completed matches: {len(results.matches)}")

for match in results.matches[:10]:
    t1 = match.team1
    t2 = match.team2
    print(f"{t1.name if t1 else 'TBD'} {t1.score if t1 else '?'} - {t2.score if t2 else '?'} {t2.name if t2 else 'TBD'} ({match.event})")

Find close matches

Completed matches include scores, so you can identify close series (e.g. 2-1 scorelines).

import vlrdevapi

results = vlrdevapi.matches.completed(return_all=True)
close = [m for m in results.matches if m.team1 and m.team2 and abs(m.team1.score - m.team2.score) <= 1]
print(f"Close matches: {len(close)}")

for m in close[:5]:
    t1 = m.team1
    t2 = m.team2
    print(f"{t1.name if t1 else 'TBD'} {t1.score if t1 else '?'} - {t2.score if t2 else '?'} {t2.name if t2 else 'TBD'} ({m.event})")

On this page