---
title: "Get a canvas by its asset ID"
method: GET
path: "/v1/canvases/{assetId}"
tags: ["Canvas"]
---

# Get a canvas by its asset ID

`GET /v1/canvases/{assetId}`

## Path parameters

- `assetId` string, required

## Response `200`

Canvas retrieved successfully

- CanvasApiResponseDto
  - `success` boolean, required — Indicates if the request was successful
  - `message` string, required — Human readable message
  - `data` object, required — Response data
    - `assetId` string, uuid, required — The canvas asset id
    - `projectId` string, uuid, required — Project the canvas belongs to
    - `document` object, required — The canvas document — placement only
      - `version` 'https://maket.ai/spec/canvas/0.1', required
      - `elements` union[], required
        - union
          - object
            - `x` number, required
            - `y` number, required
            - `w` number, required
            - `h` number, required
            - `assetId` string, uuid, required
            - `rotation` number
            - `z` integer, required
            - `type` 'image', required
          - object
            - `x` number, required
            - `y` number, required
            - `w` number, required
            - `h` number, required
            - `assetId` string, uuid, required
            - `rotation` number
            - `z` integer, required
            - `type` 'floorplan', required
            - `level` integer, required
    - `revision` integer, required — Optimistic-concurrency token
  - `timestamp` string, date-time, required — Timestamp of the response

## Changes

- **2026-09-19** `28c2b3b6b3b4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/maket/apis/virtual-architect-api/changes/v1/canvases/:assetId/get.md)

---

[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.dev/maket/apis/virtual-architect-api/revisions/ad71cae36f29?raw)