---
title: "GET /v1/designs/{designId}"
method: GET
path: "/v1/designs/{designId}"
tags: ["design"]
---

# GET /v1/designs/{designId}

`GET /v1/designs/{designId}`

Gets the metadata for a design. This includes owner information, URLs for editing and viewing, and thumbnail information.

## Path parameters

- `designId` string, required

## Response `200`

OK

- GetDesignResponse — Successful response from a `getDesign` request.
  - `design` Design, required — The design object, which contains metadata about the design.
    - `id` string, required — The design ID.
    - `title` string — The design title.
    - `owner` TeamUserSummary, required — Metadata for the user, consisting of the User ID and Team ID.
      - `user_id` string, required — The ID of the user.
      - `team_id` string, required — The ID of the user's Canva Team.
    - `thumbnail` Thumbnail — A thumbnail image representing the object.
      - `width` integer, required — The width of the thumbnail image in pixels.
      - `height` integer, required — The height of the thumbnail image in pixels.
      - `url` string, required — A URL for retrieving the thumbnail image. This URL expires after 15 minutes. This URL includes a query string that's required for retrieving the thumbnail.
    - `urls` DesignLinks, required — A temporary set of URLs for viewing or editing the design.
      - `edit_url` string, required — A temporary editing URL for the design. This URL is only accessible to the user that made the API request, and is designed to support [return navigation](https://www.canva.dev/docs/connect/return-navigation-guide/) workflows. NOTE: This is not a permanent URL, it is only valid for 30 days.
      - `view_url` string, required — A temporary viewing URL for the design. This URL is only accessible to the user that made the API request, and is designed to support [return navigation](https://www.canva.dev/docs/connect/return-navigation-guide/) workflows. NOTE: This is not a permanent URL, it is only valid for 30 days.
    - `created_at` integer, required — When the design was created in Canva, as a Unix timestamp (in seconds since the Unix Epoch).
    - `updated_at` integer, required — When the design was last updated in Canva, as a Unix timestamp (in seconds since the Unix Epoch).
    - `page_count` integer — The total number of pages in the design. Some design types don't have pages (for example, Canva docs).
    - `design_types` DesignTypeOutputName[], required — The type of content a design or page contains. The list of design types may grow over time. The `unknown` value represents design types that haven't been added to the list.

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `default` — Error Response

---

[API](https://skmtc.net/canva/apis/canva-connect-api.md) · [All operations](https://skmtc.net/canva/apis/canva-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/canva/canva-connect-api/versions/499c392c7720/schema)