---
title: "Get item details"
method: GET
path: "/v1/mascots/{id}/items/{itemId}"
tags: ["Items"]
---

# Get item details

`GET /v1/mascots/{id}/items/{itemId}`

## Request

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

Returns the item record with all its generated assets (images, animations, logos). Returns 404 if the item does not exist or is not in the given mascot. No credit cost.

## Path parameters

- `id` string, uuid, required
- `itemId` string, uuid, required

## Response `200`

Item details with assets

- StudioItemResponse
  - `data` StudioItemWithAssets, 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
    - `assets` StudioAsset[], 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
      - `mascot_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

## 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/91eb3006a92f?raw)