Events
Event management endpoints for creating, updating, and querying events. Events can be one-time or recurring, and can take place in Genesis City or Worlds.
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.
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
100Number of events to skip (for pagination)
0Filter events by time range.
active(default): current and future eventsall: every event without time restrictionlive: events currently runningupcoming: future events onlyhighlight: deprecated alias forlist=active&highlighted=true
activePossible values: 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")
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
Unauthorized - authentication required
Internal server error
GET /api/events HTTP/1.1
Host: events.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"ok": true,
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Metaverse Music Festival",
"description": "Join us for an amazing music festival in the metaverse!",
"image": "https://events-cdn.decentraland.org/poster/abc123.jpg",
"image_vertical": "https://events-cdn.decentraland.org/poster/abc123-vertical.jpg",
"start_at": "2024-12-25T18:00:00.000Z",
"finish_at": "2024-12-25T20:00:00.000Z",
"next_start_at": "2024-12-25T18:00:00.000Z",
"next_finish_at": "2024-12-25T20:00:00.000Z",
"duration": 7200000,
"all_day": false,
"x": 20,
"y": 30,
"coordinates": [
20,
30
],
"position": [
1
],
"server": "fenrir-amber",
"url": "https://play.decentraland.org/?position=20,30",
"user": "0x1234567890123456789012345678901234567890",
"user_name": "Alice",
"estate_id": "text",
"estate_name": "Dragon City",
"scene_name": "text",
"approved": false,
"rejected": false,
"rejection_reason": "text",
"approved_by": "text",
"rejected_by": "text",
"highlighted": false,
"trending": false,
"recurrent": false,
"recurrent_frequency": "YEARLY",
"recurrent_interval": 1,
"recurrent_count": 1,
"recurrent_until": "2026-01-01T00:00:00.000Z",
"recurrent_weekday_mask": 62,
"recurrent_month_mask": 4095,
"recurrent_setpos": 1,
"recurrent_monthday": 1,
"recurrent_dates": [
"2026-01-01T00:00:00.000Z"
],
"contact": "[email protected]",
"details": "text",
"categories": [
"music",
"art"
],
"schedules": [
"123e4567-e89b-12d3-a456-426614174000"
],
"world": false,
"place_id": "123e4567-e89b-12d3-a456-426614174000",
"community_id": "123e4567-e89b-12d3-a456-426614174000",
"featured_item": "urn:decentraland:matic:collections-v2:0x1234567890abcdef1234567890abcdef12345678",
"total_attendees": 42,
"latest_attendees": [
"text"
],
"attending": true,
"live": true,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"connected_addresses": [
"0x1234567890123456789012345678901234567890"
]
}
]
}Creates a new event. Requires authentication. Events are created in pending status and require approval unless the user has special permissions.
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
URN of a wearable/emote item or collection to feature in the event
^urn:decentraland:(matic|ethereum|amoy|sepolia):collections-v2:0x[a-fA-F0-9]{40}(:\d+)?$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
POST /api/events HTTP/1.1
Host: events.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 728
{
"name": "text",
"description": "text",
"image": "https://example.com",
"image_vertical": "https://example.com",
"start_at": "2026-01-01T00:00:00.000Z",
"duration": 1,
"all_day": false,
"x": 1,
"y": 1,
"server": "text",
"url": "https://example.com",
"contact": "text",
"details": "text",
"categories": [
"text"
],
"schedules": [
"123e4567-e89b-12d3-a456-426614174000"
],
"world": false,
"community_id": "123e4567-e89b-12d3-a456-426614174000",
"featured_item": "text",
"recurrent": false,
"recurrent_frequency": "YEARLY",
"recurrent_interval": 1,
"recurrent_count": 1,
"recurrent_until": "2026-01-01T00:00:00.000Z",
"recurrent_weekday_mask": 1,
"recurrent_month_mask": 1,
"recurrent_setpos": 1,
"recurrent_monthday": 1,
"approved": true,
"rejected": true,
"highlighted": true,
"trending": true
}{
"ok": true,
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Metaverse Music Festival",
"description": "Join us for an amazing music festival in the metaverse!",
"image": "https://events-cdn.decentraland.org/poster/abc123.jpg",
"image_vertical": "https://events-cdn.decentraland.org/poster/abc123-vertical.jpg",
"start_at": "2024-12-25T18:00:00.000Z",
"finish_at": "2024-12-25T20:00:00.000Z",
"next_start_at": "2024-12-25T18:00:00.000Z",
"next_finish_at": "2024-12-25T20:00:00.000Z",
"duration": 7200000,
"all_day": false,
"x": 20,
"y": 30,
"coordinates": [
20,
30
],
"position": [
1
],
"server": "fenrir-amber",
"url": "https://play.decentraland.org/?position=20,30",
"user": "0x1234567890123456789012345678901234567890",
"user_name": "Alice",
"estate_id": "text",
"estate_name": "Dragon City",
"scene_name": "text",
"approved": false,
"rejected": false,
"rejection_reason": "text",
"approved_by": "text",
"rejected_by": "text",
"highlighted": false,
"trending": false,
"recurrent": false,
"recurrent_frequency": "YEARLY",
"recurrent_interval": 1,
"recurrent_count": 1,
"recurrent_until": "2026-01-01T00:00:00.000Z",
"recurrent_weekday_mask": 62,
"recurrent_month_mask": 4095,
"recurrent_setpos": 1,
"recurrent_monthday": 1,
"recurrent_dates": [
"2026-01-01T00:00:00.000Z"
],
"contact": "[email protected]",
"details": "text",
"categories": [
"music",
"art"
],
"schedules": [
"123e4567-e89b-12d3-a456-426614174000"
],
"world": false,
"place_id": "123e4567-e89b-12d3-a456-426614174000",
"community_id": "123e4567-e89b-12d3-a456-426614174000",
"featured_item": "urn:decentraland:matic:collections-v2:0x1234567890abcdef1234567890abcdef12345678",
"total_attendees": 42,
"latest_attendees": [
"text"
],
"attending": true,
"live": true,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"connected_addresses": [
"0x1234567890123456789012345678901234567890"
]
}
}Alternative endpoint for searching events using POST method. Accepts the same parameters as GET /events but via request body.
List of events
trueBad request - invalid parameters or body
Internal server error
POST /api/events/search HTTP/1.1
Host: events.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 259
{
"limit": 1,
"offset": 1,
"list": "all",
"highlighted": true,
"position": "text",
"positions": [
"text"
],
"creator": "text",
"only_attendee": true,
"search": "text",
"schedule": "text",
"world": true,
"world_names": [
"text"
],
"places_ids": [
"text"
],
"community_id": "text",
"order": "asc"
}{
"ok": true,
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Metaverse Music Festival",
"description": "Join us for an amazing music festival in the metaverse!",
"image": "https://events-cdn.decentraland.org/poster/abc123.jpg",
"image_vertical": "https://events-cdn.decentraland.org/poster/abc123-vertical.jpg",
"start_at": "2024-12-25T18:00:00.000Z",
"finish_at": "2024-12-25T20:00:00.000Z",
"next_start_at": "2024-12-25T18:00:00.000Z",
"next_finish_at": "2024-12-25T20:00:00.000Z",
"duration": 7200000,
"all_day": false,
"x": 20,
"y": 30,
"coordinates": [
20,
30
],
"position": [
1
],
"server": "fenrir-amber",
"url": "https://play.decentraland.org/?position=20,30",
"user": "0x1234567890123456789012345678901234567890",
"user_name": "Alice",
"estate_id": "text",
"estate_name": "Dragon City",
"scene_name": "text",
"approved": false,
"rejected": false,
"rejection_reason": "text",
"approved_by": "text",
"rejected_by": "text",
"highlighted": false,
"trending": false,
"recurrent": false,
"recurrent_frequency": "YEARLY",
"recurrent_interval": 1,
"recurrent_count": 1,
"recurrent_until": "2026-01-01T00:00:00.000Z",
"recurrent_weekday_mask": 62,
"recurrent_month_mask": 4095,
"recurrent_setpos": 1,
"recurrent_monthday": 1,
"recurrent_dates": [
"2026-01-01T00:00:00.000Z"
],
"contact": "[email protected]",
"details": "text",
"categories": [
"music",
"art"
],
"schedules": [
"123e4567-e89b-12d3-a456-426614174000"
],
"world": false,
"place_id": "123e4567-e89b-12d3-a456-426614174000",
"community_id": "123e4567-e89b-12d3-a456-426614174000",
"featured_item": "urn:decentraland:matic:collections-v2:0x1234567890abcdef1234567890abcdef12345678",
"total_attendees": 42,
"latest_attendees": [
"text"
],
"attending": true,
"live": true,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"connected_addresses": [
"0x1234567890123456789012345678901234567890"
]
}
]
}Returns all events that the authenticated user has marked as attending.
List of events user is attending
trueUnauthorized - authentication required
Internal server error
GET /api/events/attending HTTP/1.1
Host: events.decentraland.org
Accept: */*
{
"ok": true,
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Metaverse Music Festival",
"description": "Join us for an amazing music festival in the metaverse!",
"image": "https://events-cdn.decentraland.org/poster/abc123.jpg",
"image_vertical": "https://events-cdn.decentraland.org/poster/abc123-vertical.jpg",
"start_at": "2024-12-25T18:00:00.000Z",
"finish_at": "2024-12-25T20:00:00.000Z",
"next_start_at": "2024-12-25T18:00:00.000Z",
"next_finish_at": "2024-12-25T20:00:00.000Z",
"duration": 7200000,
"all_day": false,
"x": 20,
"y": 30,
"coordinates": [
20,
30
],
"position": [
1
],
"server": "fenrir-amber",
"url": "https://play.decentraland.org/?position=20,30",
"user": "0x1234567890123456789012345678901234567890",
"user_name": "Alice",
"estate_id": "text",
"estate_name": "Dragon City",
"scene_name": "text",
"approved": false,
"rejected": false,
"rejection_reason": "text",
"approved_by": "text",
"rejected_by": "text",
"highlighted": false,
"trending": false,
"recurrent": false,
"recurrent_frequency": "YEARLY",
"recurrent_interval": 1,
"recurrent_count": 1,
"recurrent_until": "2026-01-01T00:00:00.000Z",
"recurrent_weekday_mask": 62,
"recurrent_month_mask": 4095,
"recurrent_setpos": 1,
"recurrent_monthday": 1,
"recurrent_dates": [
"2026-01-01T00:00:00.000Z"
],
"contact": "[email protected]",
"details": "text",
"categories": [
"music",
"art"
],
"schedules": [
"123e4567-e89b-12d3-a456-426614174000"
],
"world": false,
"place_id": "123e4567-e89b-12d3-a456-426614174000",
"community_id": "123e4567-e89b-12d3-a456-426614174000",
"featured_item": "urn:decentraland:matic:collections-v2:0x1234567890abcdef1234567890abcdef12345678",
"total_attendees": 42,
"latest_attendees": [
"text"
],
"attending": true,
"live": true,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"connected_addresses": [
"0x1234567890123456789012345678901234567890"
]
}
]
}Retrieves detailed information about a specific event. If authenticated, includes whether the user is attending.
When called with the service bearer token (Authorization: Bearer ...), pending and rejected events are returned regardless of approval state.
Event UUID
Event details
trueNot found - resource doesn't exist
Internal server error
Service unavailable - endpoint disabled or dependency unavailable
GET /api/events/{event_id} HTTP/1.1
Host: events.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"ok": true,
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Metaverse Music Festival",
"description": "Join us for an amazing music festival in the metaverse!",
"image": "https://events-cdn.decentraland.org/poster/abc123.jpg",
"image_vertical": "https://events-cdn.decentraland.org/poster/abc123-vertical.jpg",
"start_at": "2024-12-25T18:00:00.000Z",
"finish_at": "2024-12-25T20:00:00.000Z",
"next_start_at": "2024-12-25T18:00:00.000Z",
"next_finish_at": "2024-12-25T20:00:00.000Z",
"duration": 7200000,
"all_day": false,
"x": 20,
"y": 30,
"coordinates": [
20,
30
],
"position": [
1
],
"server": "fenrir-amber",
"url": "https://play.decentraland.org/?position=20,30",
"user": "0x1234567890123456789012345678901234567890",
"user_name": "Alice",
"estate_id": "text",
"estate_name": "Dragon City",
"scene_name": "text",
"approved": false,
"rejected": false,
"rejection_reason": "text",
"approved_by": "text",
"rejected_by": "text",
"highlighted": false,
"trending": false,
"recurrent": false,
"recurrent_frequency": "YEARLY",
"recurrent_interval": 1,
"recurrent_count": 1,
"recurrent_until": "2026-01-01T00:00:00.000Z",
"recurrent_weekday_mask": 62,
"recurrent_month_mask": 4095,
"recurrent_setpos": 1,
"recurrent_monthday": 1,
"recurrent_dates": [
"2026-01-01T00:00:00.000Z"
],
"contact": "[email protected]",
"details": "text",
"categories": [
"music",
"art"
],
"schedules": [
"123e4567-e89b-12d3-a456-426614174000"
],
"world": false,
"place_id": "123e4567-e89b-12d3-a456-426614174000",
"community_id": "123e4567-e89b-12d3-a456-426614174000",
"featured_item": "urn:decentraland:matic:collections-v2:0x1234567890abcdef1234567890abcdef12345678",
"total_attendees": 42,
"latest_attendees": [
"text"
],
"attending": true,
"live": true,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"connected_addresses": [
"0x1234567890123456789012345678901234567890"
]
}
}Soft-deletes an event. The event row is preserved but flagged as deleted and hidden from every listing. The delete is terminal: a deleted event cannot be restored.
The flag set depends on the actor:
the creator deleting their own event sets
deleted_by_user(no notification).an admin (signed-in admin/editor, or the service bearer token) deleting another user's event sets
deleted_by_adminand notifies the creator (in-app + email).
An optional reason (stored as deleted_reason) may be provided for admin deletions. When called with the service bearer token, the actor is identified via the actor field.
Event UUID
Optional reason stored as deleted_reason (admin deletions).
Actor identifier, only honored with the service bearer token.
Event deleted successfully
trueBad request - invalid parameters or body
Unauthorized - authentication required
Forbidden - insufficient permissions
Not found - resource doesn't exist
Internal server error
Service unavailable - endpoint disabled or dependency unavailable
DELETE /api/events/{event_id} HTTP/1.1
Host: events.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 32
{
"reason": "text",
"actor": "text"
}{
"ok": true,
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Metaverse Music Festival",
"description": "Join us for an amazing music festival in the metaverse!",
"image": "https://events-cdn.decentraland.org/poster/abc123.jpg",
"image_vertical": "https://events-cdn.decentraland.org/poster/abc123-vertical.jpg",
"start_at": "2024-12-25T18:00:00.000Z",
"finish_at": "2024-12-25T20:00:00.000Z",
"next_start_at": "2024-12-25T18:00:00.000Z",
"next_finish_at": "2024-12-25T20:00:00.000Z",
"duration": 7200000,
"all_day": false,
"x": 20,
"y": 30,
"coordinates": [
20,
30
],
"position": [
1
],
"server": "fenrir-amber",
"url": "https://play.decentraland.org/?position=20,30",
"user": "0x1234567890123456789012345678901234567890",
"user_name": "Alice",
"estate_id": "text",
"estate_name": "Dragon City",
"scene_name": "text",
"approved": false,
"rejected": false,
"rejection_reason": "text",
"approved_by": "text",
"rejected_by": "text",
"highlighted": false,
"trending": false,
"recurrent": false,
"recurrent_frequency": "YEARLY",
"recurrent_interval": 1,
"recurrent_count": 1,
"recurrent_until": "2026-01-01T00:00:00.000Z",
"recurrent_weekday_mask": 62,
"recurrent_month_mask": 4095,
"recurrent_setpos": 1,
"recurrent_monthday": 1,
"recurrent_dates": [
"2026-01-01T00:00:00.000Z"
],
"contact": "[email protected]",
"details": "text",
"categories": [
"music",
"art"
],
"schedules": [
"123e4567-e89b-12d3-a456-426614174000"
],
"world": false,
"place_id": "123e4567-e89b-12d3-a456-426614174000",
"community_id": "123e4567-e89b-12d3-a456-426614174000",
"featured_item": "urn:decentraland:matic:collections-v2:0x1234567890abcdef1234567890abcdef12345678",
"total_attendees": 42,
"latest_attendees": [
"text"
],
"attending": true,
"live": true,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"connected_addresses": [
"0x1234567890123456789012345678901234567890"
]
}
}Updates an existing event. Users can only update their own events unless they have special permissions. Some fields require admin permissions.
When called with the service bearer token (Authorization: Bearer ...), permission checks are bypassed and the request body identifies the actor via the actor field. The body may alternatively contain only approval/rejection fields (approved, rejected, reason) to transition the event state without re-validating every editable attribute — see EventAdminActor and EventAdminReject.
Event UUID
Event updated successfully
trueBad request - invalid parameters or body
Unauthorized - authentication required
Forbidden - insufficient permissions
Not found - resource doesn't exist
Internal server error
Service unavailable - endpoint disabled or dependency unavailable
PATCH /api/events/{event_id} HTTP/1.1
Host: events.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 751
{
"name": "text",
"description": "text",
"image": "https://example.com",
"image_vertical": "https://example.com",
"start_at": "2026-01-01T00:00:00.000Z",
"duration": 1,
"all_day": true,
"x": 1,
"y": 1,
"server": "text",
"url": "https://example.com",
"contact": "text",
"details": "text",
"categories": [
"text"
],
"schedules": [
"123e4567-e89b-12d3-a456-426614174000"
],
"world": true,
"community_id": "123e4567-e89b-12d3-a456-426614174000",
"recurrent": true,
"recurrent_frequency": "YEARLY",
"recurrent_interval": 1,
"recurrent_count": 1,
"recurrent_until": "2026-01-01T00:00:00.000Z",
"recurrent_weekday_mask": 1,
"recurrent_month_mask": 1,
"recurrent_setpos": 1,
"recurrent_monthday": 1,
"approved": true,
"rejected": true,
"rejection_reason": "text",
"highlighted": true,
"trending": true,
"featured_item": "text"
}{
"ok": true,
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Metaverse Music Festival",
"description": "Join us for an amazing music festival in the metaverse!",
"image": "https://events-cdn.decentraland.org/poster/abc123.jpg",
"image_vertical": "https://events-cdn.decentraland.org/poster/abc123-vertical.jpg",
"start_at": "2024-12-25T18:00:00.000Z",
"finish_at": "2024-12-25T20:00:00.000Z",
"next_start_at": "2024-12-25T18:00:00.000Z",
"next_finish_at": "2024-12-25T20:00:00.000Z",
"duration": 7200000,
"all_day": false,
"x": 20,
"y": 30,
"coordinates": [
20,
30
],
"position": [
1
],
"server": "fenrir-amber",
"url": "https://play.decentraland.org/?position=20,30",
"user": "0x1234567890123456789012345678901234567890",
"user_name": "Alice",
"estate_id": "text",
"estate_name": "Dragon City",
"scene_name": "text",
"approved": false,
"rejected": false,
"rejection_reason": "text",
"approved_by": "text",
"rejected_by": "text",
"highlighted": false,
"trending": false,
"recurrent": false,
"recurrent_frequency": "YEARLY",
"recurrent_interval": 1,
"recurrent_count": 1,
"recurrent_until": "2026-01-01T00:00:00.000Z",
"recurrent_weekday_mask": 62,
"recurrent_month_mask": 4095,
"recurrent_setpos": 1,
"recurrent_monthday": 1,
"recurrent_dates": [
"2026-01-01T00:00:00.000Z"
],
"contact": "[email protected]",
"details": "text",
"categories": [
"music",
"art"
],
"schedules": [
"123e4567-e89b-12d3-a456-426614174000"
],
"world": false,
"place_id": "123e4567-e89b-12d3-a456-426614174000",
"community_id": "123e4567-e89b-12d3-a456-426614174000",
"featured_item": "urn:decentraland:matic:collections-v2:0x1234567890abcdef1234567890abcdef12345678",
"total_attendees": 42,
"latest_attendees": [
"text"
],
"attending": true,
"live": true,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"connected_addresses": [
"0x1234567890123456789012345678901234567890"
]
}
}Last updated