> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/apis/apis/marketplace-server/catalog.md).
# Catalog
Browse and search marketplace catalog items
## Get marketplace catalog (v1)
> Retrieves the marketplace catalog with items available for browsing and purchase.\
> Supports filtering by category, price range, and various item attributes.\
> Authentication is optional but recommended for personalized results.\
> \
> \*\*Note\*\*: Consider using /v2/catalog for enhanced features and performance.\
> \
> \*\*Pagination:\*\* Uses \`first\` and \`skip\` parameters.\
> \
> This endpoint shares all the same filter parameters as /v1/items, plus catalog-specific options.
```json
{"openapi":"3.1.0","info":{"title":"Decentraland Marketplace Server API","version":"1.0.0"},"tags":[{"name":"Catalog","description":"Browse and search marketplace catalog items"}],"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/catalog":{"get":{"tags":["Catalog"],"summary":"Get marketplace catalog (v1)","description":"Retrieves the marketplace catalog with items available for browsing and purchase.\nSupports filtering by category, price range, and various item attributes.\nAuthentication is optional but recommended for personalized results.\n\n**Note**: Consider using /v2/catalog for enhanced features and performance.\n\n**Pagination:** Uses `first` and `skip` parameters.\n\nThis endpoint shares all the same filter parameters as /v1/items, plus catalog-specific options.\n","operationId":"getCatalog","parameters":[{"name":"first","in":"query","required":false,"description":"Maximum number of items to return (default: 20)","schema":{"type":"number","default":20}},{"name":"skip","in":"query","required":false,"description":"Number of items to skip for pagination (default: 0)","schema":{"type":"number","default":0}},{"name":"sortBy","in":"query","required":false,"description":"Sort results by specified criteria","schema":{"type":"string","enum":["newest","recently_sold","cheapest","most_expensive","recently_listed"]}},{"name":"sortDirection","in":"query","required":false,"description":"Sort direction","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"onlyListing","in":"query","required":false,"description":"Show only items with active listings","schema":{"type":"boolean"}},{"name":"onlyMinting","in":"query","required":false,"description":"Show only items available for minting","schema":{"type":"boolean"}},{"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.","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","schema":{"type":"string"}},{"name":"maxPrice","in":"query","required":false,"description":"Maximum price filter in ETH/MATIC","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":"Marketplace catalog","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"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"}},"additionalProperties":true,"required":["id","name","category"]},"description":"List of catalog items"},"total":{"type":"number","description":"Total number of items"}},"required":["items","total"]}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"},"code":{"type":"string","description":"Error code"}},"required":["error"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"},"code":{"type":"string","description":"Error code"}},"required":["error"]}}}}}}}}}
```
## Get marketplace catalog (v2 - Recommended)
> Retrieves the marketplace catalog with enhanced filtering and sorting capabilities.\
> \
> \*\*Supports comprehensive filtering by:\*\*\
> \- Categories (wearables, emotes)\
> \- Price ranges and sorting\
> \- Rarities and creator addresses\
> \- Wearable-specific filters (gender, category, accessories, smart wearables)\
> \- Emote-specific filters (category, play mode, sound, geometry)\
> \- Text search across item names and descriptions\
> \
> \*\*Pagination:\*\* Uses \`first\` and \`skip\` parameters.\
> \
> Authentication is optional but may provide personalized results and user-specific data.\
> \
> This endpoint accepts all the same parameters as /v1/catalog.
```json
{"openapi":"3.1.0","info":{"title":"Decentraland Marketplace Server API","version":"1.0.0"},"tags":[{"name":"Catalog","description":"Browse and search marketplace catalog items"}],"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":{"/v2/catalog":{"get":{"tags":["Catalog"],"summary":"Get marketplace catalog (v2 - Recommended)","description":"Retrieves the marketplace catalog with enhanced filtering and sorting capabilities.\n\n**Supports comprehensive filtering by:**\n- Categories (wearables, emotes)\n- Price ranges and sorting\n- Rarities and creator addresses\n- Wearable-specific filters (gender, category, accessories, smart wearables)\n- Emote-specific filters (category, play mode, sound, geometry)\n- Text search across item names and descriptions\n\n**Pagination:** Uses `first` and `skip` parameters.\n\nAuthentication is optional but may provide personalized results and user-specific data.\n\nThis endpoint accepts all the same parameters as /v1/catalog.\n","operationId":"getCatalogV2","parameters":[{"name":"first","in":"query","required":false,"description":"Maximum number of items to return (default: 20)","schema":{"type":"number","default":20}},{"name":"skip","in":"query","required":false,"description":"Number of items to skip for pagination (default: 0)","schema":{"type":"number","default":0}},{"name":"sortBy","in":"query","required":false,"description":"Sort results by specified criteria","schema":{"type":"string","enum":["newest","recently_sold","cheapest","most_expensive","recently_listed"]}},{"name":"sortDirection","in":"query","required":false,"description":"Sort direction","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"onlyListing","in":"query","required":false,"description":"Show only items with active listings","schema":{"type":"boolean"}},{"name":"onlyMinting","in":"query","required":false,"description":"Show only items available for minting","schema":{"type":"boolean"}},{"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.","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","schema":{"type":"string"}},{"name":"maxPrice","in":"query","required":false,"description":"Maximum price filter in ETH/MATIC","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":"Marketplace catalog v2","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"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"}},"additionalProperties":true,"required":["id","name","category"]},"description":"List of catalog items"},"total":{"type":"number","description":"Total number of items"}},"required":["items","total"]}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"},"code":{"type":"string","description":"Error code"}},"required":["error"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message"},"code":{"type":"string","description":"Error code"}},"required":["error"]}}}}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.decentraland.org/apis/apis/marketplace-server/catalog.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.