VlrDevApi

status.check_status()

Check if VLR.gg is reachable

Signature

import vlrdevapi as vlr

result = vlr.status.check_status(
    timeout: float = 5.0
) -> bool

Parameters

Prop

Type

Return Value

Type: bool

Returns True if VLR.gg is reachable, False otherwise.

Examples

Check VLR.gg Status

Check VLR.gg availability
import vlrdevapi as vlr

# Quick status check
if vlr.status.check_status():
    print("VLR.gg is online and reachable")
    
    # Safe to proceed with API calls
    matches = vlr.matches.upcoming(limit=5)
    print(f"Found {len(matches)} upcoming matches")
else:
    print("VLR.gg is down or unreachable")
    print("Please try again later")

Pre-flight Check

Pre-flight check
import vlrdevapi as vlr

def get_team_data(team_id):
    # Check status before making multiple calls
    if not vlr.status.check_status():
        print("VLR.gg is unavailable")
        return None
    
    # Proceed with API calls
    team = vlr.teams.info(team_id)
    roster = vlr.teams.roster(team_id)
    matches = vlr.teams.upcoming_matches(team_id)
    
    return {"team": team, "roster": roster, "matches": matches}

data = get_team_data(1034)

Error Handling

  • Network errors: Returns False
  • Timeouts: Returns False
  • Non-200 status codes: Returns False

The function never raises exceptions, making it safe to use as a pre-flight check.

Source

Checks: https://www.vlr.gg