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