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
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
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
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
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 (neverNone
), 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()
andstandings()
to get complete event data - Event IDs can be obtained from
list_events()
or search results
Related
events.list_events()
Browse and filter events
events.matches()
Get matches for this event
events.standings()
Get prize distribution
Source
Data scraped from: https://www.vlr.gg/event/{event_id}