events.list_events()

import vlrdevapi as vlr

result = vlr.events.list_events(
    tier: EventTier | Literal["all", "vct", "vcl", "t3", "gc", "cg", "offseason"] = "all",
    region: str | None = None,
    status: EventStatus | Literal["all", "upcoming", "ongoing", "completed"] = "all",
    page: int = 1,
    limit: int | None = None,
    timeout: float = 5.0
) -> list[ListEvent]

import vlrdevapi as vlr
from vlrdevapi.events import EventTier, EventStatus

# Get ongoing VCT events
events = vlr.events.list_events(
    tier=EventTier.VCT,
    status=EventStatus.ONGOING,
    limit=10
)

for event in events:
    print(f"{event.name}")
    print(f"  Status: {event.status}")
    print(f"  Prize: {event.prize or 'TBD'}")
    print(f"  Region: {event.region or 'Global'}")

import vlrdevapi as vlr

# Get page 2 of completed events
events = vlr.events.list_events(
    tier="gc",
    status="completed",
    page=2,
    limit=20
)

print(f"Found {len(events)} events on page 2")
for event in events:
    if event.start_date and event.end_date:
        duration = (event.end_date - event.start_date).days
        print(f"{event.name} - {duration} days")