teams.roster()
Get current team roster (active players and staff)
Signature
import vlrdevapi as vlr
result = vlr.teams.roster(
team_id: int,
timeout: float = 5.0
) -> list[RosterMember]Parameters
Prop
Type
Return Value
Type: list[RosterMember]
Returns a list of current roster members.
Prop
Type
Examples
Get Team Roster
import vlrdevapi as vlr
# Get current roster
roster = vlr.teams.roster(team_id=1034)
print(f"Roster ({len(roster)} members):")
for member in roster:
captain = "[Captain]" if member.is_captain else ""
name = member.ign or member.real_name or "Unknown"
print(f"{captain}{name} - {member.role} ({member.country})")Filter by Role
import vlrdevapi as vlr
roster = vlr.teams.roster(team_id=1034)
# Get players only
players = [m for m in roster if m.role == "Player"]
print(f"Players: {len(players)}")
for player in players:
print(f" {player.ign}")
# Get coaches
coaches = [m for m in roster if "coach" in m.role.lower()]
for coach in coaches:
print(f"Coach: {coach.real_name or coach.ign}")Get Player IDs
import vlrdevapi as vlr
roster = vlr.teams.roster(team_id=1034)
# Get all player IDs
player_ids = [m.player_id for m in roster if m.player_id is not None]
print(f"Found {len(player_ids)} players with IDs")
for player_id in player_ids:
# Get detailed player info
player = vlr.players.profile(player_id)
if player:
print(f" {player.handle}: {player.country}")Error Handling
- Network failures: Returns an empty list
[] - Invalid team ID: Returns an empty list
[] - No roster data: 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 roster: - All optional fields can be
None- check before using - Use
is_captainto identify team captain - The
rolefield is always present - Combine with
players.profile()to get detailed player information
Related
Source
Data scraped from: https://www.vlr.gg/team/{team_id}