Team Roster
Fetch the current roster for a team - players and staff with roles, captain status, and photo URLs.
team.roster(team_id) returns the current roster for a team on vlr.gg, including players and staff.
Signature
team.roster(team_id: int) -> TeamRosterParameters
Prop
Type
Returns - TeamRoster
Prop
Type
Player Fields
Prop
Type
Examples
List active players
Print all active players on the current roster.
import vlrdevapi
roster = vlrdevapi.team.roster(team_id=2593)
print(f"Players ({len(roster.players)}):")
for p in roster.players:
cap = " (c)" if p.is_captain else ""
status = ""
if not p.is_active:
status = " [inactive]"
elif p.is_sub:
status = " [sub]"
print(f" {p.ign}{cap} - {p.real_name} ({p.country}){status}")List staff members
Print all staff members and their roles.
import vlrdevapi
roster = vlrdevapi.team.roster(team_id=2593)
print(f"Staff ({len(roster.staff)}):")
for s in roster.staff:
print(f" {s.ign} - {', '.join(s.roles)}")Find substitutes and inactive players
Identify substitute and inactive players on the roster.
import vlrdevapi
roster = vlrdevapi.team.roster(team_id=2593)
subs = [p.ign for p in roster.players if p.is_sub]
inactive = [p.ign for p in roster.players if not p.is_active]
print(f"Substitutes: {subs}")
print(f"Inactive: {inactive}")Curried access
Access the roster using the curried team() shorthand.
import vlrdevapi
team = vlrdevapi.team(2593)
roster = team.roster()
for p in roster.players:
print(f"{p.ign} ({p.real_name})")Last updated on