---
title: "List items (cache-fed, paginated)"
method: GET
path: "/v1/items"
tags: ["items"]
---

# List items (cache-fed, paginated)

`GET /v1/items`

## Query parameters

- `kind` string
- `category` string
- `q` string
- `cursor` string
- `limit` integer
- `sort` 'featured' | 'newest' | 'popular' | 'name' | 'rating'

## Response `200`

Paginated item list

- ItemList
  - `items` ItemSummary[]
    - `id` string, required
    - `kind` string, required
    - `slug` string, required
    - `name` string, required
    - `description` string, nullable
    - `category` string, nullable
    - `icon` string, nullable
    - `avatar_url` string, nullable
    - `is_active` boolean
    - `is_featured` boolean
    - `is_published` boolean
    - `pricing` Pricing, required
      - `pricing_type` 'free' | 'paid' | 'subscription'
      - `price_cents` integer
      - `currency` string
      - `stripe_price_id` string, nullable
      - `interval` string, nullable
      - `extras` object, nullable
    - `tags` string[]
    - `rating` number
    - `reviews_count` integer
    - `downloads` integer
    - `install_count` integer
    - `latest_version` string, nullable
    - `creator_handle` string, nullable
    - `updated_at` string, date-time, required
  - `next_cursor` string, nullable
  - `has_more` boolean
  - `total` integer, nullable

## Other responses

- `501` — Capability disabled on this hub

---

[API](https://skmtc.net/tesslateai/apis/tesslate-federated-marketplace-v1.md) · [All operations](https://skmtc.net/tesslateai/apis/tesslate-federated-marketplace-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tesslateai/tesslate-federated-marketplace-v1/revisions/b2706e1525df/schema)