d94e0e0f1821
List events
Retrieves a list of events based on various filters. By default returns active events (current and future) sorted by start date ascending. Supports filtering by location, creator, categories, schedules, and more.
When called with the service bearer token (Authorization: Bearer ...), the response includes pending and rejected rows and the approved / rejected query parameters are honored as explicit state filters.
Query parameters
Admin-only. Filter by approval state (only applied with bearer auth).
Admin-only. Filter by rejection state (only applied with bearer auth).
Maximum number of events to return
Number of events to skip (for pagination)
Filter events by time range.
- active (default): current and future events
- all: every event without time restriction
- live: events currently running
- upcoming: future events only
- highlight: deprecated alias for list=active&highlighted=true
When true, return only events flagged as highlighted. Combine with list to scope by time range.
Return events authored by the authenticated user across all statuses (approved, pending, and rejected). Requires signed-fetch authentication; unauthenticated callers receive 401. Overrides the creator filter when set.
Filter events at a specific Genesis City position (format "x,y")
Filter events at multiple positions
Filter events by Genesis City estate ID
Filter events by creator's Ethereum address
Show only events the authenticated user is attending (requires authentication)
Full-text search in event name and description (minimum 3 characters)
Filter events by schedule ID
Filter events by location type (true=Worlds, false=Genesis City, null=all)
Filter events by World names (format "name.dcl.eth")
Filter events by place IDs
Filter events by community ID
Sort order by start date
Start of date range filter (ISO 8601 format). Returns events with next_start_at >= from. Use with 'to' to filter events within a specific date range.
End of date range filter (ISO 8601 format). Returns events with next_start_at < to. Use with 'from' to filter events within a specific date range.
Include the list of connected user wallet addresses for each event location. When enabled, each event in the response will include a connected_addresses array containing wallet addresses of users currently at the event's location. Data is cached for 5 minutes.
Response
List of events