---
title: "GET /v1/brand-templates/{brandTemplateId}/dataset"
method: GET
path: "/v1/brand-templates/{brandTemplateId}/dataset"
tags: ["brand_template"]
---

# GET /v1/brand-templates/{brandTemplateId}/dataset

`GET /v1/brand-templates/{brandTemplateId}/dataset`

## Request

- Base URL: `https://api.canva.com/rest`
- URL: `https://api.canva.com/rest/v1/brand-templates/{brandTemplateId}/dataset`
- Auth: OAuth 2 (authorization code, authorization URL `https://www.canva.com/api/oauth/authorize`, token URL `https://api.canva.com/rest/v1/oauth/token`, scopes: `brandtemplate:content:read`)

AVAILABILITY: To use this API, your app 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).

Gets the dataset definition of a brand template. If the brand
template contains autofill data fields, this API returns an object with the data field
names and the type of data they accept.

<Note>

To get the dataset definition of a design, use the
[Get design dataset API](https://www.canva.dev/docs/apps/rest-apis/reference/designs/get-design-dataset/).

</Note>

Available data field types include:

- Images (which you can autofill with an image or a video asset)
- Text
- Charts
- Sheets

You can autofill a brand template using the [Create a design autofill job
API](https://www.canva.dev/docs/apps/rest-apis/reference/autofills/create-design-autofill-job/).

## Path parameters

- `brandTemplateId` string, required

## Response `200`

OK

- GetBrandTemplateDatasetResponse: Successful response from a `getBrandTemplateDataset` request.
  - `dataset` object: The dataset definition. It contains the data inputs available for use with the [Create design autofill job API](https://www.canva.dev/docs/apps/rest-apis/reference/autofills/create-design-autofill-job/).

## Other responses

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

## Changes

- **2026-10-19** `40ca7f6a753b`: 3 warning
  - added the new `user_linked_to_another_idp` enum value to the `code` response property for the response status `403`
  - added the new `user_linked_to_another_idp` enum value to the `code` response property for the response status `404`
  - added the new `user_linked_to_another_idp` enum value to the `code` response property for the response status `default`
- **2026-09-21** `ded190b8f3ba`: 1 breaking, 1 info
  - added `#/components/schemas/SheetDataField` to the `dataset/additionalProperties/` response property `oneOf` list for the response status `200`
  - added `sheet` discriminator mapping keys to the `dataset/additionalProperties/` response property for the response status `200`
- **2026-09-17** `5ea5a3f48e72`: 3 warning
  - added the new `asset_not_ready` enum value to the `code` response property for the response status `403`
  - added the new `asset_not_ready` enum value to the `code` response property for the response status `404`
  - added the new `asset_not_ready` enum value to the `code` response property for the response status `default`
- …earlier changes not shown

[Operation history](https://skmtc.dev/canva/apis/canva-connect-api/changes/v1/brand-templates/:brandTemplateId/dataset/get.md)

---

[API](https://skmtc.dev/canva/apis/canva-connect-api.md) · [All operations](https://skmtc.dev/canva/apis/canva-connect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/canva/apis/canva-connect-api/revisions/056061f65796?raw)