---
title: "List Items"
method: GET
path: "/v1/marketplace/items"
tags: ["marketplace"]
---

# List Items

`GET /v1/marketplace/items`

## Query parameters

- `type` 'code' | 'course' | 'tutorial' | 'skill' | 'prompt' | 'rule' | 'template' | 'project' | 'hackathon'
- `search` string, nullable — Search in title, description, tags
- `tags` string, nullable — Comma-separated tags (AND logic)
- `author` string, nullable — Filter by author username
- `minRating` number, nullable — Minimum rating (0-5)
- `sort` string — Sort: popular | newest | rating | ratingCount | downloads | updated
- `sortBy` string, nullable — Alias for `sort` (accepts the same tokens, e.g. popularity)
- `page` integer — Page number
- `limit` integer — Items per page
- `featured` boolean, nullable — Filter by featured status

## Response `200`

Successful Response

- MarketplaceItemListResponse
  - `items` MarketplaceItemListItem[], required
    - `id` string, required
    - `type` 'code' | 'course' | 'tutorial' | 'skill' | 'prompt' | 'rule' | 'template' | 'project' | 'hackathon', required
    - `title` string, required
    - `description` string, required
    - `author` string, required
    - `authorId` integer, required
    - `rating` number, required
    - `ratingCount` integer, required
    - `downloads` integer, required
    - `tags` string[], nullable
    - `thumbnailUrl` string, nullable
    - `version` string, required
    - `license` string, required
    - `price` number
    - `currency` string
    - `isFree` boolean
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `featured` boolean
    - `verified` boolean
    - `status` 'draft' | 'submitted' | 'approved' | 'rejected' | 'unpublished'
    - `submittedAt` string, date-time, nullable
    - `reviewedAt` string, date-time, nullable
    - `rejectionReason` string, nullable
  - `pagination` PaginationMeta, required
    - `page` integer, required
    - `limit` integer, required
    - `total` integer, required
    - `totalPages` integer, required
  - `meta` object, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/kodik/apis/kodik-api.md) · [All operations](https://skmtc.dev/kodik/apis/kodik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kodik/kodik-api/revisions/55c71b347360/schema)