---
title: "List Decentraland Worlds"
method: GET
path: "/worlds"
tags: ["Worlds"]
---

# List Decentraland Worlds

`GET /worlds`

Retrieve a paginated list of Decentraland Worlds with filtering and sorting.

**Worlds vs Places:** Worlds are privately owned virtual spaces accessed via unique URLs,
while Places are scenes in Genesis City at specific coordinates.

**Common Queries:**
- Most active worlds: `?order_by=most_active`
- Search by name: `?search=party`
- Specific worlds: `?names=world-name-1&names=world-name-2`

## Query parameters

- `limit` integer
- `offset` integer
- `names` string[]
- `only_favorites` boolean
- `order_by` 'like_score' | 'most_active' | 'created_at'
- `order` 'asc' | 'desc'
- `search` string
- `categories` string[]
- `disabled` boolean
- `owner` string

## Response `200`

Worlds retrieved successfully

- object
  - `ok` boolean
  - `data` object[]
    - `id` string, uuid — Unique world identifier
    - `title` string, nullable — World name
    - `description` string, nullable — World description
    - `image` string, uri, nullable — World thumbnail URL
    - `owner` string, nullable — Owner's Ethereum address
    - `positions` string[] — Coordinate placeholders (worlds don't use Genesis City coordinates)
    - `base_position` string — Base coordinate placeholder
    - `contact_name` string, nullable
    - `contact_email` string, nullable
    - `content_rating` string, nullable — Content rating
    - `likes` integer
    - `dislikes` integer
    - `like_score` number, nullable
    - `like_rate` number, nullable
    - `ranking` number, nullable — External ranking value for custom ordering
    - `highlighted` boolean — True if this world is highlighted/featured by administrators
    - `favorites` integer
    - `disabled` boolean — True if world opted out of listing
    - `disabled_at` string, date-time, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `deployed_at` string, date-time
    - `user_like` boolean
    - `user_dislike` boolean
    - `user_favorite` boolean
    - `user_count` integer — Current users in the world
    - `user_visits` integer — Visits in last 30 days
    - `creator_address` string, nullable — The creator's wallet address
    - `sdk` string, nullable — SDK/runtime version (e.g., "7" for SDK7)
    - `connected_addresses` string[] — List of wallet addresses currently connected to this world. Only included when `with_connected_users=true` query parameter is set.
  - `total` integer — Total number of worlds matching the query

## Other responses

- `400` — Bad request - Invalid parameters or malformed request

---

[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)