Users

User-owned assets including wearables, emotes, names, and lands

Get user's wearables

get

/users/{address}/wearables

Retrieves all on-chain wearables owned by a specific Ethereum address. Supports pagination, filtering by category/rarity/name, and sorting. Optionally includes definitions or entity metadata.

Path parameters

addressstringRequired

Ethereum address (0x-prefixed)

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

Query parameters

pageNuminteger · min: 1Optional

Page number (1-indexed)

Default: 1

pageSizeinteger · min: 1 · max: 1000Optional

Number of items per page (max 1000)

Default: 100

categorystring[]Optional

Filter by category (can be specified multiple times)

raritystring · enumOptional

Filter by rarity

Possible values:

namestringOptional

Filter by name (case-insensitive substring match)

orderBystring · enumOptional

Sort field

Default: rarityPossible values:

directionstring · enumOptional

Sort direction

Default: DESCPossible values:

includeDefinitionsbooleanOptional

Include item definitions in response

Default: false

includeEntitiesbooleanOptional

Include entity metadata in response (cannot be used with includeDefinitions)

Default: false

Responses

200

List of user's wearables

application/json

totalAmountintegerOptional

Total number of items across all pages

pageNumintegerOptional

Current page number

pageSizeintegerOptional

Number of items per page

400

Bad request - Invalid parameters

application/json

get/users/{address}/wearables

GET /lambdas/users/{address}/wearables HTTP/1.1
Host: peer.decentraland.org
Accept: */*

{
  "elements": [
    {
      "urn": "text",
      "amount": 1,
      "individualData": [
        {
          "id": "text",
          "tokenId": "text",
          "transferredAt": 1,
          "price": 1
        }
      ],
      "name": "text",
      "category": "text",
      "rarity": "common",
      "definition": {
        "id": "text",
        "name": "text",
        "description": "text",
        "rarity": "text",
        "category": "text",
        "data": {}
      },
      "entity": {
        "version": "text",
        "id": "text",
        "type": "text",
        "pointers": [
          "text"
        ],
        "timestamp": 1,
        "content": [
          {
            "file": "text",
            "hash": "text"
          }
        ],
        "metadata": {}
      }
    }
  ],
  "totalAmount": 1,
  "pageNum": 1,
  "pageSize": 1
}

Get user's emotes

get

/users/{address}/emotes

Retrieves all on-chain emotes owned by a specific Ethereum address. Supports pagination, filtering by category/rarity/name, and sorting. Optionally includes definitions or entity metadata.

Path parameters

addressstringRequired

Ethereum address (0x-prefixed)

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

Query parameters

pageNuminteger · min: 1Optional

Page number (1-indexed)

Default: 1

pageSizeinteger · min: 1 · max: 1000Optional

Number of items per page (max 1000)

Default: 100

categorystring[]Optional

Filter by category (can be specified multiple times)

raritystring · enumOptional

Filter by rarity

Possible values:

namestringOptional

Filter by name (case-insensitive substring match)

orderBystring · enumOptional

Sort field

Default: rarityPossible values:

directionstring · enumOptional

Sort direction

Default: DESCPossible values:

includeDefinitionsbooleanOptional

Include item definitions in response

Default: false

includeEntitiesbooleanOptional

Include entity metadata in response (cannot be used with includeDefinitions)

Default: false

Responses

200

List of user's emotes

application/json

totalAmountintegerOptional

Total number of items across all pages

pageNumintegerOptional

Current page number

pageSizeintegerOptional

Number of items per page

400

Bad request - Invalid parameters

application/json

get/users/{address}/emotes

GET /lambdas/users/{address}/emotes HTTP/1.1
Host: peer.decentraland.org
Accept: */*

{
  "elements": [
    {
      "urn": "text",
      "amount": 1,
      "individualData": [
        {
          "id": "text",
          "tokenId": "text",
          "transferredAt": 1,
          "price": 1
        }
      ],
      "name": "text",
      "category": "text",
      "rarity": "common",
      "definition": {
        "id": "text",
        "name": "text",
        "description": "text",
        "rarity": "text",
        "category": "text",
        "data": {}
      },
      "entity": {
        "version": "text",
        "id": "text",
        "type": "text",
        "pointers": [
          "text"
        ],
        "timestamp": 1,
        "content": [
          {
            "file": "text",
            "hash": "text"
          }
        ],
        "metadata": {}
      }
    }
  ],
  "totalAmount": 1,
  "pageNum": 1,
  "pageSize": 1
}

Get user's names

get

/users/{address}/names

Retrieves all Decentraland names (ENS-like) owned by a specific Ethereum address

Path parameters

addressstringRequired

Ethereum address (0x-prefixed)

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

Query parameters

pageNuminteger · min: 1Optional

Page number (1-indexed)

Default: 1

pageSizeinteger · min: 1 · max: 1000Optional

Number of items per page (max 1000)

Default: 100

Responses

200

List of user's names

application/json

totalAmountintegerOptional

Total number of items across all pages

pageNumintegerOptional

Current page number

pageSizeintegerOptional

Number of items per page

get/users/{address}/names

GET /lambdas/users/{address}/names HTTP/1.1
Host: peer.decentraland.org
Accept: */*

200

List of user's names

{
  "elements": [
    {
      "name": "text",
      "contractAddress": "text",
      "tokenId": "text",
      "price": 1
    }
  ],
  "totalAmount": 1,
  "pageNum": 1,
  "pageSize": 1
}

Get user's lands

get

/users/{address}/lands

Retrieves all LAND and Estate NFTs owned by a specific Ethereum address

Path parameters

addressstringRequired

Ethereum address (0x-prefixed)

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

Query parameters

pageNuminteger · min: 1Optional

Page number (1-indexed)

Default: 1

pageSizeinteger · min: 1 · max: 1000Optional

Number of items per page (max 1000)

Default: 100

Responses

200

List of user's lands

application/json

totalAmountintegerOptional

Total number of items across all pages

pageNumintegerOptional

Current page number

pageSizeintegerOptional

Number of items per page

get/users/{address}/lands

GET /lambdas/users/{address}/lands HTTP/1.1
Host: peer.decentraland.org
Accept: */*

200

List of user's lands

{
  "elements": [
    {
      "contractAddress": "text",
      "tokenId": "text",
      "category": "parcel",
      "name": "text",
      "x": "text",
      "y": "text",
      "description": "text",
      "price": 1,
      "image": "text"
    }
  ],
  "totalAmount": 1,
  "pageNum": 1,
  "pageSize": 1
}