---
title: "Get marketplace catalog (v1)"
method: GET
path: "/v1/catalog"
tags: ["Catalog"]
---

# Get marketplace catalog (v1)

`GET /v1/catalog`

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.

## Query parameters

- `first` number
- `skip` number
- `sortBy` 'newest' | 'recently_sold' | 'cheapest' | 'most_expensive' | 'recently_listed'
- `sortDirection` 'asc' | 'desc'
- `onlyListing` boolean
- `onlyMinting` boolean
- `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`

Marketplace catalog

- object
  - `items` object[], required — List of catalog items
    - `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
  - `total` number, required — Total number of items

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

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