Profiles

User profile retrieval and metadata endpoints

Get profiles by addresses

post

https://asset-bundle-registry.decentraland.org

/profiles

Returns validated Catalyst profiles for the given Ethereum addresses. Profiles include avatar information, names, wearables, and snapshot URLs.

The service maintains a multi-layer cache (memory and database) for fast profile retrieval and periodically validates profile ownership to ensure data freshness.

Profile snapshots (face and body images) are returned as URLs pointing to the profile images CDN rather than content hashes.

Body

application/json

idsstring[]Required

List of Ethereum addresses to fetch profiles for

Responses

200

List of profiles

application/json

Profile data transfer object with avatar information

timestampnumberRequired

Unix timestamp (milliseconds) when the profile was deployed

post/profiles

HTTPcURLJavaScriptPython

POST /profiles HTTP/1.1
Host: asset-bundle-registry.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "ids": [
    "text"
  ]
}

200

List of profiles

[
  {
    "timestamp": 1,
    "avatars": [
      {
        "userId": "text",
        "name": "text",
        "hasClaimedName": true,
        "description": "text",
        "avatar": {
          "bodyShape": "text",
          "wearables": [
            "text"
          ],
          "emotes": [
            {}
          ],
          "snapshots": {
            "face256": "text",
            "body": "text"
          },
          "eyes": {},
          "hair": {},
          "skin": {}
        }
      }
    ]
  }
]

Get profile metadata by addresses

post

https://asset-bundle-registry.decentraland.org

/profiles/metadata

Returns lightweight metadata for profiles at the given Ethereum addresses. This endpoint returns only essential profile information (name, claimed name status, thumbnail URL) without full avatar details, making it suitable for displaying profile cards or lists.

Body

application/json

idsstring[]Required

List of Ethereum addresses to fetch profiles for

Responses

200

List of profile metadata

application/json

Lightweight profile metadata for display purposes

pointerstringRequired

Ethereum address of the profile owner

hasClaimedNamebooleanRequired

Whether the user has claimed a unique Decentraland name

namestringRequired

Display name for the profile

thumbnailUrlstringRequired

URL to the profile's face thumbnail image

post/profiles/metadata

HTTPcURLJavaScriptPython

POST /profiles/metadata HTTP/1.1
Host: asset-bundle-registry.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "ids": [
    "text"
  ]
}

200

List of profile metadata

[
  {
    "pointer": "text",
    "hasClaimedName": true,
    "name": "text",
    "thumbnailUrl": "text"
  }
]