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=1189)

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=1189)

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=1189)

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")

Format Event Display

Format event display
import vlrdevapi as vlr

def format_event_card(event_id):
    event = vlr.events.info(event_id)
    if not event:
        return "Event not found"
    
    card = f"""
{event.name}
"""
    if event.subtitle:
        card += f"   {event.subtitle}\n"
    
    card += f"""
Prize: {event.prize or 'TBD'}
Location: {event.location or 'Online'}
Dates: {event.date_text or 'TBD'}
"""
    
    if event.regions:
        card += f"Regions: {', '.join(event.regions)}\n"
    
    return card.strip()

print(format_event_card(1189))

Error Handling

This function returns None instead of raising exceptions, making it safe to use without try-catch blocks.

  • 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.

Tips

  • The regions field is always a list (never None), but may be empty []
  • Use date_text for display purposes; it contains human-readable date ranges
  • The prize field includes currency symbols and formatting from VLR.gg
  • Combine with matches() and standings() to get complete event data
  • Event IDs can be obtained from list_events() or search results

Source

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