---
title: "List and search marketplace collections"
method: GET
path: "/v1/collections"
tags: ["Collections"]
---

# List and search marketplace collections

`GET /v1/collections`

Retrieves marketplace collections with their metadata and statistics.

Supports comprehensive filtering:
- Search by collection name or text
- Filter by creator address
- Filter by contract address or URN
- Show only collections with items on sale
- Network filtering

Sorting options:
- Newest collections
- Recently reviewed
- Alphabetical by name
- By collection size (item count)
- Recently listed

Use this endpoint to:
- Browse marketplace collections
- Search for specific creator's collections
- Display collection catalogs
- Track new collection launches

Results include collection metadata, item counts, and listing status.

## Query parameters

- `first` number
- `skip` number
- `sortBy` 'newest' | 'recently_reviewed' | 'name' | 'size' | 'recently_listed'
- `name` string
- `search` string
- `creator` string
- `urn` string
- `contractAddress` string
- `isOnSale` boolean
- `network` 'ETHEREUM' | 'MATIC'

## Response `200`

List of collections

- object
  - `data` object[], required
    - `urn` string, required — Collection URN (Uniform Resource Name)
    - `creator` string, required — Creator wallet address
    - `name` string, required — Collection name
    - `contractAddress` string, required — Smart contract address of the collection
    - `createdAt` number, required — Creation timestamp (Unix epoch in milliseconds)
    - `updatedAt` number, required — Last update timestamp (Unix epoch in milliseconds)
    - `reviewedAt` number, required — Review timestamp (Unix epoch in milliseconds)
    - `isOnSale` boolean, required — Whether the collection has items currently on sale
    - `size` number, required — Number of items in the collection
    - `network` 'ETHEREUM' | 'MATIC', required — Blockchain network where the collection is deployed
    - `chainId` number, required — Chain ID of the blockchain network
    - `firstListedAt` number, nullable, required — Timestamp when first item was listed (Unix epoch in milliseconds, null if never listed)
  - `total` number, required — Total number of collections matching the filters

## Other responses

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