Tiles

Endpoints for retrieving map tile data. Tiles represent individual parcels and their properties in the Decentraland virtual world.

Get all map tiles

get

https://api.decentraland.orghttps://api.decentraland.zone

/v2/tiles

Returns all tiles in the Decentraland map with detailed information about each parcel. This endpoint supports filtering by coordinates and field selection to optimize payload size.

Filtering Options

• Coordinate filtering: Use x1, y1, x2, y2 to request a specific area

• Field inclusion: Use 'include' to select specific fields

• Field exclusion: Use 'exclude' to omit specific fields

Caching

This endpoint includes Last-Modified headers and supports conditional requests with If-Modified-Since.

Query parameters

x1integerOptional

Minimum X coordinate for bounding box filter

Example: -150

y1integerOptional

Minimum Y coordinate for bounding box filter

Example: -150

x2integerOptional

Maximum X coordinate for bounding box filter

Example: 150

y2integerOptional

Maximum Y coordinate for bounding box filter

Example: 150

includestringOptional

Comma-separated list of fields to include in each tile

Example: id,x,y,type,owner,price

excludestringOptional

Comma-separated list of fields to exclude from each tile

Example: updatedAt,tokenId

Responses

200

Successful response with tile data

application/json

301

Redirect to S3-hosted tiles (when feature flag is enabled)

503

Service not ready

text/plain

get

/v2/tiles

HTTPcURLJavaScriptPython

GET /v2/tiles HTTP/1.1
Host: api.decentraland.org
Accept: */*

{
  "ok": true,
  "data": {
    "ANY_ADDITIONAL_PROPERTY": {
      "id": "23,-23",
      "x": 23,
      "y": -23,
      "nftId": "parcel-23--23",
      "type": "owned",
      "top": true,
      "left": true,
      "topLeft": false,
      "updatedAt": 1698765432000,
      "name": "My Genesis Plaza",
      "owner": "0x1234567890abcdef1234567890abcdef12345678",
      "estateId": "12345",
      "tokenId": "115792089237316195423570985008687907832452644793752989267978113781140059103329",
      "price": 10000.5,
      "expiresAt": 1699000000,
      "rentalListing": {
        "expiration": 1699000000000,
        "periods": [
          {
            "pricePerDay": "100000000000000000000",
            "minDays": 1,
            "maxDays": 30
          }
        ],
        "updatedAt": 1698700000000
      }
    }
  }
}

Deprecated

Get all map tiles (Legacy format)

get

https://api.decentraland.orghttps://api.decentraland.zone

/v1/tiles

DEPRECATED: This endpoint returns tiles in the legacy format. Please use /v2/tiles instead.

Returns all tiles in the map using the older data format. This endpoint is maintained for backward compatibility but will be removed in a future version.

Query parameters

x1integerOptional

y1integerOptional

x2integerOptional

y2integerOptional

includestringOptional

excludestringOptional

Responses

200

Successful response with legacy tile data

application/json

okbooleanOptional

301

Redirect to S3-hosted tiles

503

Service not ready

get

/v1/tiles

HTTPcURLJavaScriptPython

GET /v1/tiles HTTP/1.1
Host: api.decentraland.org
Accept: */*

{
  "ok": true,
  "data": {}
}

Get tiles metadata information

get

https://api.decentraland.orghttps://api.decentraland.zone

/v2/tiles/info

Returns metadata about the tiles dataset, including the last update timestamp. This endpoint is useful for cache invalidation and determining when to refresh data.

Responses

200

Successful response with tiles info

application/json

503

Service not ready

get

/v2/tiles/info

HTTPcURLJavaScriptPython

GET /v2/tiles/info HTTP/1.1
Host: api.decentraland.org
Accept: */*

{
  "lastUpdatedAt": 1698765432000
}