latestOpenAPI 3.1.02026-08-1013317298.0 KB

d94e0e0f1821

Events

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.

get/events

Query parameters

approvedboolean

Admin-only. Filter by approval state (only applied with bearer auth).

rejectedboolean

Admin-only. Filter by rejection state (only applied with bearer auth).

limitinteger

Maximum number of events to return

offsetinteger

Number of events to skip (for pagination)

list'all' | 'active' | 'live' | 'upcoming' | 'highlight'

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
highlightedboolean

When true, return only events flagged as highlighted. Combine with list to scope by time range.

ownerboolean

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.

positionstring

Filter events at a specific Genesis City position (format "x,y")

positionsstring[]

Filter events at multiple positions

estate_idstring

Filter events by Genesis City estate ID

creatorstring

Filter events by creator's Ethereum address

only_attendeeboolean

Show only events the authenticated user is attending (requires authentication)

searchstring

Full-text search in event name and description (minimum 3 characters)

schedulestring uuid

Filter events by schedule ID

worldboolean

Filter events by location type (true=Worlds, false=Genesis City, null=all)

world_namesstring[]

Filter events by World names (format "name.dcl.eth")

places_idsstring[]

Filter events by place IDs

community_idstring uuid

Filter events by community ID

order'asc' | 'desc'

Sort order by start date

fromstring date-time

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.

tostring date-time

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.

with_connected_usersboolean

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

okboolean