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

# GET /v1/designs

`GET /v1/designs`

Lists metadata for all the designs in a Canva user's
[projects](https://www.canva.com/help/find-designs-and-folders/). You can also:

- Use search terms to filter the listed designs.
- Show designs either created by, or shared with the user.
- Sort the results.

## Query parameters

- `query` string
- `continuation` string
- `ownership` 'any' | 'owned' | 'shared'
- `sort_by` 'relevance' | 'modified_descending' | 'modified_ascending' | 'title_descending' | 'title_ascending'
- `limit` integer

## Response `200`

OK

- GetListDesignResponse
  - `continuation` string — A continuation token. If the success response contains a continuation token, the list contains more designs you can list. You can use this token as a query parameter and retrieve more designs from the list, for example `/v1/designs?continuation={continuation}`. To retrieve all of a user's designs, you might need to make multiple requests.
  - `items` Design[], required — The list of designs.
    - `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

- `400` — Bad Request
- `403` — Forbidden
- `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)