# Items
View marketplace items and collections
## List marketplace 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.
```json
{"openapi":"3.1.0","info":{"title":"Decentraland Marketplace Server API","version":"1.0.0"},"tags":[{"name":"Items","description":"View marketplace items and collections"}],"servers":[{"url":"https://marketplace-api.decentraland.org","description":"Production server"},{"url":"https://marketplace-api.decentraland.zone","description":"Development server"}],"security":[{"SignedFetch":[]},{}],"components":{"securitySchemes":{"SignedFetch":{"type":"http","scheme":"bearer","description":"Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). \nRequires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. \nSee http://adr.decentraland.org/adr/ADR-44l for details.\n"}}},"paths":{"/v1/items":{"get":{"tags":["Items"],"summary":"List marketplace items","description":"Retrieves items from marketplace collections.\nItems are templates/blueprints for NFTs in collections (e.g., wearable designs, emote templates).\n\n**Filter capabilities:**\n- Specific contract address and item ID\n- Category (wearable, emote)\n- Creator addresses (multiple allowed)\n- Sale and sold-out status\n- Text search by name or description\n- Price range filtering\n- Wearable filters: category, gender, head/accessory/smart types\n- Emote filters: category, play mode, sound, geometry\n- Network selection (Ethereum, Polygon)\n- URN and ID filtering\n\n**Pagination:** Uses `first` and `skip` parameters (NOT `limit`/`offset`).\n\nAuthentication is optional but may provide personalized results including pick statistics.\n","operationId":"getItems","parameters":[{"name":"first","in":"query","required":false,"description":"Maximum number of items to return (default: 100)","schema":{"type":"number","default":100}},{"name":"skip","in":"query","required":false,"description":"Number of items to skip for pagination (default: 0)","schema":{"type":"number","default":0}},{"name":"category","in":"query","required":false,"description":"Filter by NFT category","schema":{"type":"string","enum":["wearable","emote"]}},{"name":"creator","in":"query","required":false,"description":"Filter by creator wallet address(es). Can be repeated for multiple creators.","schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"isSoldOut","in":"query","required":false,"description":"Filter by sold out status","schema":{"type":"boolean"}},{"name":"isOnSale","in":"query","required":false,"description":"Filter by whether item is currently on sale","schema":{"type":"boolean"}},{"name":"search","in":"query","required":false,"description":"Text search across item names and descriptions","schema":{"type":"string"}},{"name":"isWearableHead","in":"query","required":false,"description":"Filter for head wearables only","schema":{"type":"boolean"}},{"name":"isWearableAccessory","in":"query","required":false,"description":"Filter for accessory wearables only","schema":{"type":"boolean"}},{"name":"isWearableSmart","in":"query","required":false,"description":"Filter for smart wearables only","schema":{"type":"boolean"}},{"name":"wearableCategory","in":"query","required":false,"description":"Filter by specific wearable category","schema":{"type":"string","enum":["eyebrows","eyes","facial_hair","hair","body_shape","mouth","upper_body","lower_body","feet","earring","eyewear","hat","helmet","mask","tiara","top_head","skin","hands_wear"]}},{"name":"rarity","in":"query","required":false,"description":"Filter by rarity. Can be repeated for multiple rarities.","schema":{"type":"array","items":{"type":"string","enum":["unique","mythic","exotic","legendary","epic","rare","uncommon","common"]}},"style":"form","explode":true},{"name":"wearableGender","in":"query","required":false,"description":"Filter by wearable gender compatibility. Can be repeated.","schema":{"type":"array","items":{"type":"string","enum":["male","female","unisex"]}},"style":"form","explode":true},{"name":"emoteCategory","in":"query","required":false,"description":"Filter by emote category","schema":{"type":"string","enum":["dance","stunt","greetings","fun","poses","reactions","horror","miscellaneous"]}},{"name":"emoteGender","in":"query","required":false,"description":"Filter by emote gender compatibility. Can be repeated.","schema":{"type":"array","items":{"type":"string","enum":["male","female","unisex"]}},"style":"form","explode":true},{"name":"emotePlayMode","in":"query","required":false,"description":"Filter by emote play mode. Can be repeated.","schema":{"type":"array","items":{"type":"string","enum":["simple","loop"]}},"style":"form","explode":true},{"name":"emoteHasGeometry","in":"query","required":false,"description":"Filter for emotes with geometry/props","schema":{"type":"boolean"}},{"name":"emoteHasSound","in":"query","required":false,"description":"Filter for emotes with sound","schema":{"type":"boolean"}},{"name":"contractAddress","in":"query","required":false,"description":"Filter by collection contract address(es). Can be repeated.","schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"itemId","in":"query","required":false,"description":"Filter by specific item ID within a collection","schema":{"type":"string"}},{"name":"network","in":"query","required":false,"description":"Filter by blockchain network","schema":{"type":"string","enum":["ETHEREUM","MATIC"]}},{"name":"minPrice","in":"query","required":false,"description":"Minimum price filter in ETH/MATIC (e.g., \"0.1\")","schema":{"type":"string"}},{"name":"maxPrice","in":"query","required":false,"description":"Maximum price filter in ETH/MATIC (e.g., \"100\")","schema":{"type":"string"}},{"name":"urn","in":"query","required":false,"description":"Filter by item URN(s). Can be repeated.","schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"id","in":"query","required":false,"description":"Filter by item ID(s). Can be repeated.","schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true}],"responses":{"200":{"description":"List of items with total count","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Item ID"},"name":{"type":"string","description":"Item name"},"description":{"type":"string","description":"Item description"},"image":{"type":"string","description":"Item image URL"},"category":{"type":"string","description":"Item category"},"rarity":{"type":"string","description":"Item rarity"},"price":{"type":"number","description":"Item price"},"owner":{"type":"string","description":"Item owner"}},"required":["id","name","category"]}},"total":{"type":"number","description":"Total number of items matching the filters"}},"required":["data","total"]}}}},"400":{"description":"Bad request - invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"},"code":{"type":"string","description":"Error code"}},"required":["error"]}}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.decentraland.org/apis/apis/marketplace-server/items.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.