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
chevron-right
200

List of user's wearables

application/json
get
/users/{address}/wearables

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
chevron-right
200

List of user's emotes

application/json
get
/users/{address}/emotes

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
chevron-right
200

List of user's names

application/json
get
/users/{address}/names
200

List of user's names

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
chevron-right
200

List of user's lands

application/json
get
/users/{address}/lands
200

List of user's lands

Last updated