---
title: "List items in a collection"
method: GET
path: "/v1/collections/{id}/items"
tags: ["Items"]
deprecated: true
---

# List items in a collection

`GET /v1/collections/{id}/items`

## Request

- Base URL: `https://api.masko.ai`
- URL: `https://api.masko.ai/v1/collections/{id}/items`
- Auth: HTTP bearer

> **Deprecated.**

Returns paginated items in a collection. An item groups related assets (e.g. "wave" item may have an image, a transparent image, and animation variants). Filter by `type` to narrow results. No credit cost.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` number: Page size. 1 to 100. Defaults to 50.
- `offset` number, nullable: Number of records to skip. Defaults to 0.
- `cursor` string: Opaque next_cursor from the previous page. Use instead of offset.
- `type` string

## Response `200`

List of items

- ItemListResponse
  - `data` Item[], required
    - `object` 'item': Resource type. Always "item".
    - `id` string, uuid, required
    - `name` string, required
    - `type` string, required
    - `prompt` string, required
    - `public_slug` string, nullable, required
    - `metadata` object, nullable
    - `created_at` string, required
  - `meta` Meta, required
    - `pagination` Pagination
      - `total` integer, required
      - `limit` integer, required
      - `offset` integer, required
      - `has_more` boolean, required
      - `next_cursor` string, nullable: Pass as the cursor query parameter to get the next page. Null on the last page.

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict

---

[API](https://skmtc.dev/masko/apis/masko-api.md) · [All operations](https://skmtc.dev/masko/apis/masko-api/llms.txt) · [OpenAPI document](https://skmtc.dev/masko/apis/masko-api/revisions/84832e255613?raw)