---
title: "List events"
method: GET
path: "/events"
tags: ["Events"]
---

# List events

`GET /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

- `approved` boolean
- `rejected` boolean
- `limit` integer
- `offset` integer
- `list` 'all' | 'active' | 'live' | 'upcoming' | 'highlight'
- `highlighted` boolean
- `owner` boolean
- `position` string
- `positions` string[]
- `estate_id` string
- `creator` string
- `only_attendee` boolean
- `search` string
- `schedule` string, uuid
- `world` boolean
- `world_names` string[]
- `places_ids` string[]
- `community_id` string, uuid
- `order` 'asc' | 'desc'
- `from` string, date-time
- `to` string, date-time
- `with_connected_users` boolean

## Response `200`

List of events

- object
  - `ok` boolean
  - `data` object[]
    - `id` string, uuid, required — Unique event identifier
    - `name` string, required — Event name
    - `description` string — Event description in Markdown format
    - `image` string, uri, nullable — URL to event poster image (horizontal format)
    - `image_vertical` string, uri, nullable — URL to event poster image in vertical/portrait format
    - `start_at` string, date-time, required — Event start date and time
    - `finish_at` string, date-time — Event end date and time
    - `next_start_at` string, date-time — Next occurrence start time (for recurring events)
    - `next_finish_at` string, date-time — Next occurrence end time (for recurring events)
    - `duration` integer, required — Event duration in milliseconds
    - `all_day` boolean — Whether this is an all-day event
    - `x` integer, required — X coordinate in Genesis City (not used for World events)
    - `y` integer, required — Y coordinate in Genesis City (not used for World events)
    - `coordinates` integer[] — Deprecated - use x and y instead
    - `position` integer[] — Alias for coordinates
    - `server` string, nullable — Realm/server name
    - `url` string, uri — Jump-in URL to the event location
    - `user` string, required — Ethereum address of event creator
    - `user_name` string, nullable — Display name of event creator
    - `estate_id` string, nullable — Genesis City estate ID (if applicable)
    - `estate_name` string, nullable — Genesis City estate name (if applicable)
    - `scene_name` string, nullable — Deprecated - scene name
    - `approved` boolean — Whether the event has been approved by a moderator
    - `rejected` boolean — Whether the event has been rejected by a moderator
    - `rejection_reason` string, nullable — Reason provided by a moderator or service when rejecting the event
    - `approved_by` string, nullable — Wallet address or service actor that approved the event
    - `rejected_by` string, nullable — Wallet address or service actor that rejected the event
    - `highlighted` boolean — Whether the event is highlighted in the UI
    - `trending` boolean — Whether the event is marked as trending
    - `recurrent` boolean — Whether this is a recurring event
    - `recurrent_frequency` 'YEARLY' | 'MONTHLY' | 'WEEKLY' | 'DAILY' | 'HOURLY' | 'MINUTELY' | 'SECONDLY', nullable — Recurrence frequency (RRule FREQ)
    - `recurrent_interval` integer — Recurrence interval (RRule INTERVAL)
    - `recurrent_count` integer, nullable — Number of recurrences (RRule COUNT)
    - `recurrent_until` string, date-time, nullable — Recurrence end date (RRule UNTIL)
    - `recurrent_weekday_mask` integer — Weekday mask for recurrence (bit flags for days of week)
    - `recurrent_month_mask` integer — Month mask for recurrence (bit flags for months)
    - `recurrent_setpos` integer, nullable — Position in recurrence set (RRule BYSETPOS)
    - `recurrent_monthday` integer, nullable — Day of month for recurrence (RRule BYMONTHDAY)
    - `recurrent_dates` string[] — Calculated recurrence dates
    - `contact` string, nullable — Contact information for event organizer
    - `details` string, nullable — Additional event details
    - `categories` string[] — Event category names
    - `schedules` string[] — Schedule IDs this event belongs to
    - `world` boolean — Whether this event is in a World (true) or Genesis City (false)
    - `place_id` string, uuid, nullable — Place ID (from Places API)
    - `community_id` string, uuid, nullable — Community ID this event is associated with
    - `total_attendees` integer — Total number of users attending
    - `latest_attendees` string[] — Ethereum addresses of latest attendees
    - `attending` boolean — Whether the authenticated user is attending (only when authenticated)
    - `live` boolean — Whether the event is currently happening
    - `created_at` string, date-time — Event creation timestamp
    - `updated_at` string, date-time — Event last update timestamp
    - `connected_addresses` string[] — List of wallet addresses currently connected to the event location. Only included when with_connected_users=true. Data is cached for 5 minutes.

## Other responses

- `400` — Bad request - invalid parameters or body
- `401` — Unauthorized - authentication required
- `500` — Internal server error

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)