---
title: "Fetch multiple assets by IDs"
method: GET
path: "/v1/assets"
tags: ["Assets"]
---

# Fetch multiple assets by IDs

`GET /v1/assets`

## Query parameters

- `ids` union, required
  - string[]
  - unknown

## Response `200`

Assets retrieved successfully

- ExpandedAssetArrayApiResponseDto
  - `success` boolean, required — Indicates if the request was successful
  - `message` string, required — Human readable message
  - `data` union[], required — Response data
    - union
      - object
        - `id` string, uuid, required — Unique identifier of the asset
        - `collectionId` string, uuid, required — ID of the collection this asset belongs to
        - `folderId` string, uuid, nullable — ID of the folder this asset belongs to
        - `name` string, required — Name of the asset
        - `type` 'image', required
        - `thumbnailUrls` string[], required — Ordered preview thumbnail URLs
        - `metadata` unknown, required
        - `lockedAt` unknown, required
        - `isLocked` boolean, required — Whether the asset is currently locked (computed from lockedAt and TTL)
        - `deletedAt` unknown
        - `createdAt` unknown, required
        - `updatedAt` unknown, required
        - `details` object, required
          - `mimeType` string, required — Mimetype of the storage file
          - `fileUrl` string, uri, required — URL using file's storage key
          - `sizeInBytes` integer, required — Storage file size
      - object
        - `id` string, uuid, required — Unique identifier of the asset
        - `collectionId` string, uuid, required — ID of the collection this asset belongs to
        - `folderId` string, uuid, nullable — ID of the folder this asset belongs to
        - `name` string, required — Name of the asset
        - `type` 'document', required
        - `thumbnailUrls` string[], required — Ordered preview thumbnail URLs
        - `metadata` unknown, required
        - `lockedAt` unknown, required
        - `isLocked` boolean, required — Whether the asset is currently locked (computed from lockedAt and TTL)
        - `deletedAt` unknown
        - `createdAt` unknown, required
        - `updatedAt` unknown, required
        - `details` object, required
          - `mimeType` string, required — Mimetype of the storage file
          - `fileUrl` string, uri, required — URL using file's storage key
          - `sizeInBytes` integer, required — Storage file size
      - object
        - `id` string, uuid, required — Unique identifier of the asset
        - `collectionId` string, uuid, required — ID of the collection this asset belongs to
        - `folderId` string, uuid, nullable — ID of the folder this asset belongs to
        - `name` string, required — Name of the asset
        - `type` 'floorplan', required
        - `thumbnailUrls` string[], required — Ordered preview thumbnail URLs
        - `metadata` unknown, required
        - `lockedAt` unknown, required
        - `isLocked` boolean, required — Whether the asset is currently locked (computed from lockedAt and TTL)
        - `deletedAt` unknown
        - `createdAt` unknown, required
        - `updatedAt` unknown, required
        - `details` object[], required — Array of floor entities
          - `level` integer, required — Level of floor
          - `origin` 'generated' | 'drawn' | 'uploaded' | 'recognized', nullable, required — How this floor was created; null for legacy pre-column floors
          - `floorplanData` object, required — Floorplan data JSON
            - `unit` 'cm', required
            - `version` string, required
            - `floorNumber` integer, required
            - `floorName` string
            - `Vertices` object[], required
              - …
            - `Edges` object[], required
              - …
            - `Faces` object[], required
              - …
            - `Fixtures` object[], required
              - …
            - `UnattachedOpenings` union[]
              - …
          - `visualizerStyleBindings` object[], required — Visualizer style bindings for the floor
            - `elementUid` string, uuid, required
            - `elementType` 'all' | 'floor' | 'room' | 'wall' | 'door' | 'window' | 'fixture' | 'ceiling' | 'exterior_wall', required
            - `category` 'general_floor' | 'bathroom_floor' | 'wall' | 'door' | 'window' | 'hard_furniture' | 'soft_furniture' | 'kitchen_countertops' | 'kitchen_cabinets' | 'bathroom_countertops' | 'bathroom_cabinets' | 'rugs' | 'plants' | 'appliances' | 'plumbing_fixtures' | 'waterproof' | 'outdoor_furniture' | 'upholstered' | 'ceiling' | 'deck' | 'balcony' | 'front_porch' | 'gym_equipment' | 'pool_table' | 'ping_pong' | 'yoga_mat', nullable
            - `selectedStyleId` string, uuid, nullable, required
            - `selectedMaterialIds` string[], required
            - `selectedInspirationalImageAssetIds` string[]
            - `selectedColor` string, nullable, required
            - `llmPrompt` string, nullable
            - `inherits` boolean
          - `ceilingHeightMeters` number, required — Height of ceiling in meters
          - `createdAt` unknown, required
          - `updatedAt` unknown, required
          - `cameras` object[], required
            - `id` string, uuid, required — Camera ID
            - `level` integer, required — Level of floor the camera is on
            - `name` string, required — Name of camera
            - `heightRelative` number, required
            - `position` union[], required — Position of camera
              - …
            - `rotation` number, required — Rotation of camera
            - `pitch` number, required — Camera pitch in degrees; 0 is level, positive looks down
            - `fov` number, required — Field of view of camera
            - `aspectRatio` '1:1' | '4:3' | '3:2' | '16:9' | '2:3' | '4:5' | '9:16', required — Aspect ratio for generated renders
            - `active` boolean, required — Camera active status
            - `llmPrompt` string, nullable, required
            - `inspirationImageAssetIds` string[], required — Asset IDs of inspiration images attached to this camera (max 4)
            - `renderCount` integer, required — Number of renders for this camera
            - `createdAt` unknown, required
            - `updatedAt` unknown, required
  - `timestamp` string, date-time, required — Timestamp of the response

---

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