---
title: "GET /v1/brand-templates"
method: GET
path: "/v1/brand-templates"
tags: ["brand_template"]
---

# GET /v1/brand-templates

`GET /v1/brand-templates`

WARNING: Brand templates were migrated to use a new ID format in September 2025. If your integration stores brand template IDs, you'll need to migrate to use the new IDs. Old brand template IDs will continue to be accepted for 6 months to give you time to migrate to the new IDs.

AVAILABILITY: To use this API, your integration must act on behalf of a user that's on a Canva plan with access to brand templates (such as Canva Pro, Canva Teams, or Canva Enterprise).

Get a list of the [brand templates](https://www.canva.com/help/publish-team-template/) the user has access to.

## Query parameters

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

## Response `200`

OK

- ListBrandTemplatesResponse
  - `continuation` string — If the success response contains a continuation token, the user has access to more brand templates you can list. You can use this token as a query parameter and retrieve more templates from the list, for example `/v1/brand-templates?continuation={continuation}`. To retrieve all the brand templates available to the user, you might need to make multiple requests.
  - `items` BrandTemplate[], required — The list of brand templates.
    - `id` string, required — The brand template ID.
    - `title` string, required — The brand template title, as shown in the Canva UI.
    - `view_url` string, required — A URL Canva users can visit to view the brand template.
    - `create_url` string, required — A URL Canva users can visit to create a new design from the template.
    - `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.
    - `created_at` integer, required — When the brand template was created, as a Unix timestamp (in seconds since the Unix Epoch).
    - `updated_at` integer, required — When the brand template was last updated, as a Unix timestamp (in seconds since the Unix Epoch).

## 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)
