Events
Maximum number of events to return
100Number of events to skip (for pagination)
0Filter events by time range
activePossible values: Filter events at a specific Genesis City position (format "x,y")
20,30Pattern: ^-?\d{1,3},-?\d{1,3}$Filter events at multiple positions
Filter events by Genesis City estate ID
Filter events by creator's Ethereum address
0x1234567890123456789012345678901234567890Pattern: ^0x[a-fA-F0-9]{40}$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
ascPossible values: 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.
2026-01-01T00:00:00ZEnd 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.
2026-01-31T23:59:59ZInclude 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.
falseList of events
trueBad request - invalid parameters or body
Internal server error
Schema for creating a new event
Event name
Event description in Markdown
URL to event poster (horizontal format)
URL to event poster image in vertical/portrait format
Event start date and time
Event duration in milliseconds (max 24 hours)
falseX coordinate in Genesis City
Y coordinate in Genesis City
Preferred realm/server
Custom jump-in URL
Contact information
Additional details
Event categories (max 1)
Schedule IDs (admin only)
Whether event is in a World
falseAssociated community ID
falseSelf-approve (requires permission)
Highlight event (admin only)
Mark as trending (admin only)
Event created successfully
trueBad request - invalid parameters or body
Unauthorized - authentication required
Forbidden - insufficient permissions
Internal server error
List of events
trueBad request - invalid parameters or body
Internal server error
Event UUID
Schema for updating an event (all fields optional)
URL to event poster (horizontal format)
URL to event poster image in vertical/portrait format
Event updated successfully
trueBad request - invalid parameters or body
Unauthorized - authentication required
Forbidden - insufficient permissions
Not found - resource doesn't exist
Internal server error
Last updated