Third Party

Third-party wearables and integrations

Get user's third-party wearables

get

/users/{address}/third-party-wearables

Retrieves all third-party wearables owned by a specific Ethereum address. Third-party wearables are items from external collections integrated with Decentraland.

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)

namestringOptional

Filter by name (case-insensitive substring match)

includeDefinitionsbooleanOptional

Include item definitions in response

Default: false

Responses

200

List of user's third-party 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}/third-party-wearables

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

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

Get user's third-party wearables from a specific collection

get

/users/{address}/third-party-wearables/{collectionId}

Retrieves third-party wearables owned by a user from a specific collection identified by URN

Path parameters

addressstringRequired

Ethereum address (0x-prefixed)

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

collectionIdstringRequired

The URN of the third-party collection

Example: urn:decentraland:matic:collections-thirdparty:third-party-name

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

includeDefinitionsbooleanOptional

Include item definitions in response

Default: false

Responses

200

List of user's third-party wearables from collection

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}/third-party-wearables/{collectionId}

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

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

Get all third-party integrations

get

/third-party-integrations

Returns a list of all available third-party integrations and their metadata

Responses

200

List of third-party integrations

application/json

get/third-party-integrations

GET /lambdas/third-party-integrations HTTP/1.1
Host: peer.decentraland.org
Accept: */*

200

List of third-party integrations

{
  "data": [
    {
      "name": "text",
      "description": "text",
      "urn": "text"
    }
  ]
}