---
title: "Get user's wearables"
method: GET
path: "/users/{address}/wearables"
tags: ["Users"]
---

# 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

- `address` string, required

## Query parameters

- `pageNum` integer
- `pageSize` integer
- `category` string[]
- `rarity` 'common' | 'uncommon' | 'rare' | 'epic' | 'legendary' | 'mythic' | 'unique'
- `name` string
- `orderBy` 'date' | 'rarity' | 'name'
- `direction` 'ASC' | 'DESC'
- `includeDefinitions` boolean
- `includeEntities` boolean

## Response `200`

List of user's wearables

- object
  - `elements` object[]
    - `urn` string — Universal Resource Name for the wearable
    - `amount` integer — Total number of items owned
    - `individualData` object[]
      - `id` string
      - `tokenId` string
      - `transferredAt` integer
      - `price` number
    - `name` string
    - `category` string
    - `rarity` 'common' | 'uncommon' | 'rare' | 'epic' | 'legendary' | 'mythic' | 'unique'
    - `definition` object — Wearable metadata definition
      - `id` string
      - `name` string
      - `description` string
      - `rarity` string
      - `category` string
      - `data` object
    - `entity` object — Content entity metadata
      - `version` string
      - `id` string
      - `type` string
      - `pointers` string[]
      - `timestamp` integer
      - `content` object[]
        - `file` string
        - `hash` string
      - `metadata` object
  - `totalAmount` integer — Total number of items across all pages
  - `pageNum` integer — Current page number
  - `pageSize` integer — Number of items per page

## Other responses

- `400` — Bad request - Invalid parameters

---

[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)