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.

List events

get

https://events.decentraland.org/apihttps://events.decentraland.zone/apihttp://localhost:4000/api

/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.

Query parameters

limitinteger · min: 1 · max: 1000Optional

Maximum number of events to return

Default: 100

offsetintegerOptional

Number of events to skip (for pagination)

Default: 0

liststring · enumOptional

Filter events by time range

Default: activePossible values:

positionstringOptional

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

Example: 20,30Pattern: ^-?\d{1,3},-?\d{1,3}$

positionsstring[] · max: 1000Optional

Filter events at multiple positions

estate_idstringOptional

Filter events by Genesis City estate ID

creatorstringOptional

Filter events by creator's Ethereum address

Example: 0x1234567890123456789012345678901234567890Pattern: ^0x[a-fA-F0-9]{40}$

only_attendeebooleanOptional

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

searchstring · min: 3Optional

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

schedulestring · uuidOptional

Filter events by schedule ID

worldbooleanOptional

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

world_namesstring[] · min: 1Optional

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

places_idsstring · uuid[] · max: 100Optional

Filter events by place IDs

community_idstring · uuidOptional

Filter events by community ID

orderstring · enumOptional

Sort order by start date

Default: ascPossible values:

Responses

200

List of events

application/json

400

Bad request - invalid parameters or body

application/json

500

Internal server error

application/json

get

/events

HTTPcURLJavaScriptPython

GET /api/events 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",
      "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,
      "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-21T02:33:59.247Z",
      "recurrent_weekday_mask": 62,
      "recurrent_month_mask": 4095,
      "recurrent_setpos": 1,
      "recurrent_monthday": 1,
      "recurrent_dates": [
        "2026-01-21T02:33:59.247Z"
      ],
      "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",
      "total_attendees": 42,
      "latest_attendees": [
        "text"
      ],
      "attending": true,
      "live": true,
      "created_at": "2026-01-21T02:33:59.247Z",
      "updated_at": "2026-01-21T02:33:59.247Z"
    }
  ]
}

Create a new event

post

https://events.decentraland.org/apihttps://events.decentraland.zone/apihttp://localhost:4000/api

/events

Creates a new event. Requires authentication. Events are created in pending status and require approval unless the user has special permissions.

Body

application/json

Schema for creating a new event

namestring · min: 1 · max: 150Required

Event name

descriptionstring | nullableOptional

Event description in Markdown

imagestring · uri | nullableOptional

URL to event poster

start_atstring · date-timeRequired

Event start date and time

durationinteger · max: 86400000Required

Event duration in milliseconds (max 24 hours)

all_daybooleanOptionalDefault: false

xinteger · min: -170 · max: 170Required

X coordinate in Genesis City

yinteger · min: -170 · max: 170Required

Y coordinate in Genesis City

serverstring | nullableOptional

Preferred realm/server

urlstring · uriOptional

Custom jump-in URL

contactstring | nullableOptional

Contact information

detailsstring | nullableOptional

Additional details

categoriesstring[] | nullableOptional

Event categories (max 1)

schedulesstring · uuid[] | nullableOptional

Schedule IDs (admin only)

worldbooleanOptional

Whether event is in a World

Default: false

community_idstring · uuid | nullableOptional

Associated community ID

recurrentbooleanOptionalDefault: false

recurrent_frequencystring · enum | nullableOptionalPossible values:

recurrent_intervalintegerOptional

recurrent_countinteger | nullableOptional

recurrent_untilstring · date-time | nullableOptional

recurrent_weekday_maskintegerOptional

recurrent_month_maskintegerOptional

recurrent_setposinteger | nullableOptional

recurrent_monthdayinteger | nullableOptional

approvedbooleanOptional

Self-approve (requires permission)

rejectedbooleanOptional

highlightedbooleanOptional

Highlight event (admin only)

trendingbooleanOptional

Mark as trending (admin only)

Responses

200

Event created successfully

application/json

400

Bad request - invalid parameters or body

application/json

401

Unauthorized - authentication required

application/json

403

Forbidden - insufficient permissions

application/json

500

Internal server error

application/json

post

/events

HTTPcURLJavaScriptPython

POST /api/events HTTP/1.1
Host: events.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 666

{
  "name": "text",
  "description": "text",
  "image": "https://example.com",
  "start_at": "2026-01-21T02:33:59.247Z",
  "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",
  "recurrent": false,
  "recurrent_frequency": "YEARLY",
  "recurrent_interval": 1,
  "recurrent_count": 1,
  "recurrent_until": "2026-01-21T02:33:59.247Z",
  "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",
    "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,
    "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-21T02:33:59.247Z",
    "recurrent_weekday_mask": 62,
    "recurrent_month_mask": 4095,
    "recurrent_setpos": 1,
    "recurrent_monthday": 1,
    "recurrent_dates": [
      "2026-01-21T02:33:59.247Z"
    ],
    "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",
    "total_attendees": 42,
    "latest_attendees": [
      "text"
    ],
    "attending": true,
    "live": true,
    "created_at": "2026-01-21T02:33:59.247Z",
    "updated_at": "2026-01-21T02:33:59.247Z"
  }
}

Search events

post

https://events.decentraland.org/apihttps://events.decentraland.zone/apihttp://localhost:4000/api

/events/search

Alternative endpoint for searching events using POST method. Accepts the same parameters as GET /events but via request body.

Body

application/json

limitinteger · min: 1Optional

offsetintegerOptional

liststring · enumOptionalPossible values:

positionstringOptional

positionsstring[]Optional

creatorstringOptional

only_attendeebooleanOptional

searchstringOptional

schedulestringOptional

worldbooleanOptional

world_namesstring[]Optional

places_idsstring[]Optional

community_idstringOptional

orderstring · enumOptionalPossible values:

Responses

200

List of events

application/json

400

Bad request - invalid parameters or body

application/json

500

Internal server error

application/json

post

/events/search

HTTPcURLJavaScriptPython

POST /api/events/search HTTP/1.1
Host: events.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 240

{
  "limit": 1,
  "offset": 1,
  "list": "all",
  "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",
      "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,
      "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-21T02:33:59.247Z",
      "recurrent_weekday_mask": 62,
      "recurrent_month_mask": 4095,
      "recurrent_setpos": 1,
      "recurrent_monthday": 1,
      "recurrent_dates": [
        "2026-01-21T02:33:59.247Z"
      ],
      "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",
      "total_attendees": 42,
      "latest_attendees": [
        "text"
      ],
      "attending": true,
      "live": true,
      "created_at": "2026-01-21T02:33:59.247Z",
      "updated_at": "2026-01-21T02:33:59.247Z"
    }
  ]
}

Get events the user is attending

get

https://events.decentraland.org/apihttps://events.decentraland.zone/apihttp://localhost:4000/api

/events/attending

Returns all events that the authenticated user has marked as attending.

Responses

200

List of events user is attending

application/json

401

Unauthorized - authentication required

application/json

500

Internal server error

application/json

get

/events/attending

HTTPcURLJavaScriptPython

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",
      "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,
      "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-21T02:33:59.247Z",
      "recurrent_weekday_mask": 62,
      "recurrent_month_mask": 4095,
      "recurrent_setpos": 1,
      "recurrent_monthday": 1,
      "recurrent_dates": [
        "2026-01-21T02:33:59.247Z"
      ],
      "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",
      "total_attendees": 42,
      "latest_attendees": [
        "text"
      ],
      "attending": true,
      "live": true,
      "created_at": "2026-01-21T02:33:59.247Z",
      "updated_at": "2026-01-21T02:33:59.247Z"
    }
  ]
}

Get event by ID

get

https://events.decentraland.org/apihttps://events.decentraland.zone/apihttp://localhost:4000/api

/events/{event_id}

Retrieves detailed information about a specific event. If authenticated, includes whether the user is attending.

Path parameters

event_idstring · uuidRequired

Event UUID

Responses

200

Event details

application/json

404

Not found - resource doesn't exist

application/json

500

Internal server error

application/json

get

/events/{event_id}

HTTPcURLJavaScriptPython

GET /api/events/{event_id} 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",
    "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,
    "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-21T02:33:59.247Z",
    "recurrent_weekday_mask": 62,
    "recurrent_month_mask": 4095,
    "recurrent_setpos": 1,
    "recurrent_monthday": 1,
    "recurrent_dates": [
      "2026-01-21T02:33:59.247Z"
    ],
    "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",
    "total_attendees": 42,
    "latest_attendees": [
      "text"
    ],
    "attending": true,
    "live": true,
    "created_at": "2026-01-21T02:33:59.247Z",
    "updated_at": "2026-01-21T02:33:59.247Z"
  }
}

Update an event

patch

https://events.decentraland.org/apihttps://events.decentraland.zone/apihttp://localhost:4000/api

/events/{event_id}

Updates an existing event. Users can only update their own events unless they have special permissions. Some fields require admin permissions.

Path parameters

event_idstring · uuidRequired

Event UUID

Body

application/json

Schema for updating an event (all fields optional)

namestring · min: 1 · max: 150Optional

descriptionstring | nullableOptional

imagestring · uri | nullableOptional

start_atstring · date-timeOptional

durationintegerOptional

all_daybooleanOptional

xinteger · min: -170 · max: 170Optional

yinteger · min: -170 · max: 170Optional

serverstring | nullableOptional

urlstring · uriOptional

contactstring | nullableOptional

detailsstring | nullableOptional

categoriesstring[] | nullableOptional

schedulesstring · uuid[] | nullableOptional

worldbooleanOptional

community_idstring · uuid | nullableOptional

recurrentbooleanOptional

recurrent_frequencystring · enum | nullableOptionalPossible values:

recurrent_intervalintegerOptional

recurrent_countinteger | nullableOptional

recurrent_untilstring · date-time | nullableOptional

recurrent_weekday_maskintegerOptional

recurrent_month_maskintegerOptional

recurrent_setposinteger | nullableOptional

recurrent_monthdayinteger | nullableOptional

approvedbooleanOptional

rejectedbooleanOptional

highlightedbooleanOptional

trendingbooleanOptional

Responses

200

Event updated successfully

application/json

400

Bad request - invalid parameters or body

application/json

401

Unauthorized - authentication required

application/json

403

Forbidden - insufficient permissions

application/json

404

Not found - resource doesn't exist

application/json

500

Internal server error

application/json

patch

/events/{event_id}

HTTPcURLJavaScriptPython

PATCH /api/events/{event_id} HTTP/1.1
Host: events.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 663

{
  "name": "text",
  "description": "text",
  "image": "https://example.com",
  "start_at": "2026-01-21T02:33:59.247Z",
  "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-21T02:33:59.247Z",
  "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",
    "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,
    "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-21T02:33:59.247Z",
    "recurrent_weekday_mask": 62,
    "recurrent_month_mask": 4095,
    "recurrent_setpos": 1,
    "recurrent_monthday": 1,
    "recurrent_dates": [
      "2026-01-21T02:33:59.247Z"
    ],
    "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",
    "total_attendees": 42,
    "latest_attendees": [
      "text"
    ],
    "attending": true,
    "live": true,
    "created_at": "2026-01-21T02:33:59.247Z",
    "updated_at": "2026-01-21T02:33:59.247Z"
  }
}