---
title: "Get profiles by addresses"
method: POST
path: "/profiles"
tags: ["Profiles"]
---

# Get profiles by addresses

`POST /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.

## Request body

- object
  - `ids` string[], required — List of Ethereum addresses to fetch profiles for

## Response `200`

List of profiles

- object[]
  - `timestamp` number, required — Unix timestamp (milliseconds) when the profile was deployed
  - `avatars` object[], required — List of avatar configurations for this profile
    - `userId` string — User's Ethereum address
    - `name` string — Display name for the avatar
    - `hasClaimedName` boolean — Whether the user has claimed a unique Decentraland name
    - `description` string — User-provided description
    - `avatar` object — Avatar appearance configuration
      - `bodyShape` string — Body shape URN
      - `wearables` string[] — List of equipped wearable URNs
      - `emotes` object[] — List of equipped emotes
      - `snapshots` object
        - `face256` string — URL to face snapshot image
        - `body` string — URL to body snapshot image
      - `eyes` object — Eye color configuration
      - `hair` object — Hair color configuration
      - `skin` object — Skin color configuration

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)