Worlds

Operations for Decentraland Worlds - privately owned virtual spaces that exist outside Genesis City. Worlds can be accessed via unique URLs and have their own rules and configurations.

List Decentraland Worlds

get

https://places.decentraland.org/apihttp://localhost:4000/api

/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

limitinteger · max: 100Optional

Maximum number of worlds to return (max 100)

Default: 100

offsetintegerOptional

Number of worlds to skip for pagination

Default: 0

namesstring[] · max: 1000Optional

Filter by specific world names (exact match, case-insensitive). Multiple names return worlds matching ANY name (OR logic).

Example: ["my-world","art-space"]

only_favoritesbooleanOptional

Show only authenticated user's favorite worlds (requires auth)

Default: false

order_bystring · enumOptional

Sort worlds by:

• like_score: Best rated (VP-weighted, default)
• most_active: Current user count
• created_at: Newest first

Default: like_scorePossible values:

orderstring · enumOptional

Sort direction

Default: descPossible values:

searchstring · min: 3Optional

Full-text search in world title, description (min 3 chars)

categoriesstring[]Optional

Filter by categories

disabledbooleanOptional

Include disabled/opt-out worlds in results

Default: false

ownerstringOptional

Filter by owner's Ethereum address

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

Responses

200

Worlds retrieved successfully

application/json

400

Bad request - Invalid parameters or malformed request

application/json

get

/worlds

HTTPcURLJavaScriptPython

GET /api/worlds HTTP/1.1
Host: places.decentraland.org
Accept: */*

{
  "ok": true,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "title": "text",
      "description": "text",
      "image": "https://example.com",
      "owner": "text",
      "positions": [
        "text"
      ],
      "base_position": "text",
      "contact_name": "text",
      "contact_email": "text",
      "content_rating": "text",
      "likes": 1,
      "dislikes": 1,
      "like_score": 1,
      "like_rate": 1,
      "favorites": 1,
      "disabled": true,
      "disabled_at": "2026-01-20T21:16:58.233Z",
      "created_at": "2026-01-20T21:16:58.233Z",
      "updated_at": "2026-01-20T21:16:58.233Z",
      "deployed_at": "2026-01-20T21:16:58.233Z",
      "user_like": true,
      "user_dislike": true,
      "user_favorite": true,
      "user_count": 1,
      "user_visits": 1,
      "creator_address": "text"
    }
  ],
  "total": 42
}

Get all world names

get

https://places.decentraland.org/apihttp://localhost:4000/api

/world_names

Retrieve a simple list of all registered world names.

Use Cases:

• Autocomplete for world search

• Validation of world name existence

• Browse all available worlds

Performance: Lightweight endpoint, returns only names as strings.

Responses

200

World names retrieved successfully

application/json

400

Bad request - Invalid parameters or malformed request

application/json

500

Internal server error - Something went wrong on the server

application/json

get

/world_names

HTTPcURLJavaScriptPython

GET /api/world_names HTTP/1.1
Host: places.decentraland.org
Accept: */*

{
  "ok": true,
  "data": [
    "art-gallery-world",
    "concert-venue",
    "gaming-arena"
  ]
}