VlrDevApi

events.info()

Get event header and detailed information

Signature

import vlrdevapi as vlr

result = vlr.events.info(
    event_id: int,
    timeout: float = 5.0
) -> Info | None

Parameters

Prop

Type

Return Value

Type: Info | None

Returns event header information or None if the event is not found.

Prop

Type

Examples

Get Event Information

Get event information
import vlrdevapi as vlr

# Get event details
event = vlr.events.info(event_id=2498)

if event:
    print(f"Event: {event.name}")
    if event.subtitle:
        print(f"Subtitle: {event.subtitle}")
    
    print(f"Prize Pool: {event.prize or 'Not announced'}")
    print(f"Location: {event.location or 'Online'}")
    print(f"Dates: {event.date_text or 'TBD'}")
    
    if event.regions:
        print(f"Regions: {', '.join(event.regions)}")
else:
    print("Event not found")

Combine with Other Endpoints

Combine with other endpoints
import vlrdevapi as vlr

# Get event info and matches
event = vlr.events.info(event_id=2498)

if event:
    print(f"=== {event.name} ===")
    print(f"Prize: {event.prize}")
    
    # Get matches for this event
    matches = vlr.events.matches(event_id=event.id, limit=5)
    print(f"\nUpcoming matches: {len(matches)}")
    
    for match in matches:
        print(f"  {match.teams[0].name} vs {match.teams[1].name}")

Check Event Status

Check event status
import vlrdevapi as vlr

# Check if event exists and get basic info
event_info = vlr.events.info(event_id=2498)

if event_info is None:
    print("Event does not exist")
else:
    print(f"Event exists: {event_info.name}")
    print(f"Location: {event_info.location or 'Online'}")
    
    # Check if event has regions
    if event_info.regions:
        print(f"Multi-region event: {len(event_info.regions)} regions")
    else:
        print("Single region or global event")

Error Handling

  • Network failures: Returns None
  • Invalid event ID: Returns None
  • Event not found: Returns None

Always check if the return value is not None before accessing properties.

Source

Data scraped from: https://www.vlr.gg/event/{event_id}