---
title: "List marketplace items"
method: GET
path: "/v1/items"
tags: ["Items"]
---

# List marketplace items

`GET /v1/items`

Retrieves items from marketplace collections.
Items are templates/blueprints for NFTs in collections (e.g., wearable designs, emote templates).

**Filter capabilities:**
- Specific contract address and item ID
- Category (wearable, emote)
- Creator addresses (multiple allowed)
- Sale and sold-out status
- Text search by name or description
- Price range filtering
- Wearable filters: category, gender, head/accessory/smart types
- Emote filters: category, play mode, sound, geometry
- Network selection (Ethereum, Polygon)
- URN and ID filtering

**Pagination:** Uses `first` and `skip` parameters (NOT `limit`/`offset`).

Authentication is optional but may provide personalized results including pick statistics.

## Query parameters

- `first` number
- `skip` number
- `category` 'wearable' | 'emote'
- `creator` string[]
- `isSoldOut` boolean
- `isOnSale` boolean
- `search` string
- `isWearableHead` boolean
- `isWearableAccessory` boolean
- `isWearableSmart` boolean
- `wearableCategory` 'eyebrows' | 'eyes' | 'facial_hair' | 'hair' | 'body_shape' | 'mouth' | 'upper_body' | 'lower_body' | 'feet' | 'earring' | 'eyewear' | 'hat' | 'helmet' | 'mask' | 'tiara' | 'top_head' | 'skin' | 'hands_wear'
- `rarity` string[]
- `wearableGender` string[]
- `emoteCategory` 'dance' | 'stunt' | 'greetings' | 'fun' | 'poses' | 'reactions' | 'horror' | 'miscellaneous'
- `emoteGender` string[]
- `emotePlayMode` string[]
- `emoteHasGeometry` boolean
- `emoteHasSound` boolean
- `contractAddress` string[]
- `itemId` string
- `network` 'ETHEREUM' | 'MATIC'
- `minPrice` string
- `maxPrice` string
- `urn` string[]
- `id` string[]

## Response `200`

List of items with total count

- object
  - `data` object[], required
    - `id` string, required — Item ID
    - `name` string, required — Item name
    - `description` string — Item description
    - `image` string — Item image URL
    - `category` string, required — Item category
    - `rarity` string — Item rarity
    - `price` number — Item price
    - `owner` string — Item owner
  - `total` number, required — Total number of items matching the filters

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