---
title: "List and search NFTs"
method: GET
path: "/v1/nfts"
tags: ["NFTs"]
---

# List and search NFTs

`GET /v1/nfts`

Retrieves NFTs from the Decentraland marketplace with comprehensive filtering capabilities.

**Supports multiple NFT types:**
- Wearables (clothing, accessories)
- LAND parcels and Estates
- ENS names
- Emotes

**Advanced filtering options:**
- Ownership and sale/rental status
- Categories and search text
- Price ranges (min/max)
- LAND-specific: distance to plaza, adjacent to roads, estate size
- Rental status and rental days for LAND parcels
- Wearable filters: category, gender, head/accessory/smart types
- Emote filters: category, play mode, sound, geometry
- Network selection (Ethereum mainnet, Polygon)
- Sort by: name, newest, recently listed/sold, cheapest, rental metrics

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

Authentication is optional but provides access to user-specific data like favorites.

## Query parameters

- `first` number
- `skip` number
- `sortBy` 'name' | 'newest' | 'recently_listed' | 'recently_sold' | 'cheapest' | 'rental_listing_date' | 'rented_date' | 'max_rental_price' | 'min_rental_price'
- `category` 'parcel' | 'estate' | 'wearable' | 'ens' | 'emote'
- `owner` string
- `isOnSale` boolean
- `isOnRent` boolean
- `search` string
- `isLand` boolean
- `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'
- `wearableGender` string[]
- `emoteCategory` 'dance' | 'stunt' | 'greetings' | 'fun' | 'poses' | 'reactions' | 'horror' | 'miscellaneous'
- `emoteGender` string[]
- `emotePlayMode` string[]
- `emoteHasGeometry` boolean
- `emoteHasSound` boolean
- `contractAddress` string[]
- `creator` string[]
- `tokenId` string
- `itemRarity` string[]
- `itemId` string
- `network` 'ETHEREUM' | 'MATIC'
- `rentalStatus` string[]
- `adjacentToRoad` boolean
- `minDistanceToPlaza` number
- `maxDistanceToPlaza` number
- `tenant` string
- `minPrice` string
- `maxPrice` string
- `minEstateSize` number
- `maxEstateSize` number
- `rentalDays` number[]

## Response `200`

List of NFTs with total count

- object
  - `data` object[], required
    - `id` string, required — NFT ID
    - `tokenId` string, required — Token ID
    - `contract` string, required — Contract address
    - `owner` string, required — Owner address
    - `metadata` object — NFT metadata
    - `price` number — NFT price
  - `total` number, required — Total number of NFTs 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)