# Profiles

User profile retrieval and metadata endpoints

## Get profiles by addresses

> 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.<br>

```json
{"openapi":"3.1.0","info":{"title":"Asset Bundle Registry API","version":"1.0.0"},"tags":[{"name":"Profiles","description":"User profile retrieval and metadata endpoints"}],"servers":[{"url":"https://asset-bundle-registry.decentraland.org","description":"Production server"},{"url":"/","description":"Local/relative path"}],"security":[],"paths":{"/profiles":{"post":{"tags":["Profiles"],"summary":"Get profiles by addresses","description":"Returns validated Catalyst profiles for the given Ethereum addresses. Profiles include\navatar information, names, wearables, and snapshot URLs.\n\nThe service maintains a multi-layer cache (memory and database) for fast profile retrieval\nand periodically validates profile ownership to ensure data freshness.\n\nProfile snapshots (face and body images) are returned as URLs pointing to the profile\nimages CDN rather than content hashes.\n","operationId":"getProfiles","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"},"description":"List of Ethereum addresses to fetch profiles for"}},"required":["ids"]}}}},"responses":{"200":{"description":"List of profiles","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","description":"Profile data transfer object with avatar information","properties":{"timestamp":{"type":"number","description":"Unix timestamp (milliseconds) when the profile was deployed"},"avatars":{"type":"array","items":{"type":"object","description":"Avatar configuration including appearance and wearables","properties":{"userId":{"type":"string","description":"User's Ethereum address"},"name":{"type":"string","description":"Display name for the avatar"},"hasClaimedName":{"type":"boolean","description":"Whether the user has claimed a unique Decentraland name"},"description":{"type":"string","description":"User-provided description"},"avatar":{"type":"object","description":"Avatar appearance configuration","properties":{"bodyShape":{"type":"string","description":"Body shape URN"},"wearables":{"type":"array","items":{"type":"string"},"description":"List of equipped wearable URNs"},"emotes":{"type":"array","items":{"type":"object"},"description":"List of equipped emotes"},"snapshots":{"type":"object","properties":{"face256":{"type":"string","description":"URL to face snapshot image"},"body":{"type":"string","description":"URL to body snapshot image"}}},"eyes":{"type":"object","description":"Eye color configuration"},"hair":{"type":"object","description":"Hair color configuration"},"skin":{"type":"object","description":"Skin color configuration"}}}}},"description":"List of avatar configurations for this profile"}},"required":["timestamp","avatars"]}}}}}}}}}}
```

## Get profile metadata by addresses

> 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.<br>

```json
{"openapi":"3.1.0","info":{"title":"Asset Bundle Registry API","version":"1.0.0"},"tags":[{"name":"Profiles","description":"User profile retrieval and metadata endpoints"}],"servers":[{"url":"https://asset-bundle-registry.decentraland.org","description":"Production server"},{"url":"/","description":"Local/relative path"}],"security":[],"paths":{"/profiles/metadata":{"post":{"tags":["Profiles"],"summary":"Get profile metadata by addresses","description":"Returns lightweight metadata for profiles at the given Ethereum addresses.\nThis endpoint returns only essential profile information (name, claimed name status,\nthumbnail URL) without full avatar details, making it suitable for displaying\nprofile cards or lists.\n","operationId":"getProfilesMetadata","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"},"description":"List of Ethereum addresses to fetch profiles for"}},"required":["ids"]}}}},"responses":{"200":{"description":"List of profile metadata","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","description":"Lightweight profile metadata for display purposes","properties":{"pointer":{"type":"string","description":"Ethereum address of the profile owner"},"hasClaimedName":{"type":"boolean","description":"Whether the user has claimed a unique Decentraland name"},"name":{"type":"string","description":"Display name for the profile"},"thumbnailUrl":{"type":"string","description":"URL to the profile's face thumbnail image"}},"required":["pointer","hasClaimedName","name","thumbnailUrl"]}}}}}}}}}}
```