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

# List assets in a collection

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

## Request

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

> **Deprecated.**

Returns paginated assets in a collection (images, videos, transparent variants). Each asset has a signed `file_url` (1-hour expiry) and a `cdn_url` when published. Filter by `type` or `item_id`. Set `include_file_urls=false` for faster metadata-only listings. 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
- `item_id` string, uuid
- `include_file_urls` 'true' | 'false': Whether to include signed file_url values. Defaults to true. Set false for faster metadata-only listings.

## Response `200`

List of assets

- AssetListResponse
  - `data` Asset[], required
    - `object` 'asset': Resource type. Always "asset".
    - `id` string, uuid, required
    - `type` 'interactive' | 'interactive_frame' | 'image' | 'transparent_image' | 'sticker_image' | 'svg' | 'video' | 'webm' | 'hevc' | 'stacked_video' | 'scene' | 'logo' | 'audio' | 'transcript', required
    - `status` string, required
    - `metadata` object, nullable: Media dimensions, format and public asset context. Internal generation execution details are omitted.
    - `item_id` string, uuid, nullable, required
    - `collection_id` string, uuid, nullable
    - `file_url` string, uri, nullable, required
    - `cdn_url` string, uri, nullable, required
    - `is_archived` boolean
    - `archived_at` string, 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)