--- title: "GET /v1/folders/{folderId}/items" method: GET path: "/v1/folders/{folderId}/items" tags: ["folder"] --- # GET /v1/folders/{folderId}/items `GET /v1/folders/{folderId}/items` Lists the items in a folder, including each item's `type`. Folders can contain: - Other folders. - Designs, such as Instagram posts, Presentations, and Documents ([Canva Docs](https://www.canva.com/create/documents/)). - Image assets. - Brand templates. To include `brand_template` items in the response, you must explicitly specify it in the `item_types` parameter. AVAILABILITY: Brand template items are only returned for users on a Canva plan with access to brand templates (such as Canva Pro, Canva Teams, or Canva Enterprise). For more information, see [Brand templates](https://www.canva.dev/docs/connect/api-reference/brand-templates/). Currently, video assets are not returned in the response. ## Path parameters - `folderId` string, required ## Query parameters - `continuation` string - `limit` integer — The number of folder items to return. - `item_types` FolderItemType[] - `sort_by` 'created_ascending' | 'created_descending' | 'modified_ascending' | 'modified_descending' | 'title_ascending' | 'title_descending' - `pin_status` 'any' | 'pinned' — Filter folder items by their pinned status. ## Response `200` OK - ListFolderItemsResponse — A list of the items in a folder. If the success response contains a continuation token, the folder contains more items you can list. You can use this token as a query parameter and retrieve more items from the list, for example `/v1/folders/{folderId}/items?continuation={continuation}`. To retrieve all the items in a folder, you might need to make multiple requests. - `items` FolderItemSummary[], required — An array of items in the folder. - union — Details about the folder item. - object — Details about the folder. - `type` 'folder', required - `folder` Folder, required — The folder object, which contains metadata about the folder. - `id` string, required — The folder ID. - `name` string, required — The folder name. - `created_at` integer, required — When the folder was created, as a Unix timestamp (in seconds since the Unix Epoch). - `updated_at` integer, required — When the folder was last updated, as a Unix timestamp (in seconds since the Unix Epoch). - `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. - object — Details about the design. - `type` 'design', required - `design` DesignSummary, required — Basic details about the design, such as the design's ID, title, and URL. - `id` string, required — The design ID. - `title` string — The design title. - `url` string — URL of the design. - `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). - object — Details about the image asset. - `type` 'image', required - `image` AssetSummary, required — An object representing an asset with associated metadata. - `type` 'image' | 'video', required — Type of an asset. - `id` string, required — The ID of the asset. - `name` string, required — The name of the asset. - `tags` string[], required — The user-facing tags attached to the asset. Users can add these tags to their uploaded assets, and they can search their uploaded assets in the Canva UI by searching for these tags. For information on how users use tags, see the [Canva Help Center page on asset tags](https://www.canva.com/help/add-edit-tags/). - `created_at` integer, required — When the asset was added to Canva, as a Unix timestamp (in seconds since the Unix Epoch). - `updated_at` integer, required — When the asset was last updated in Canva, as a Unix timestamp (in seconds since the Unix Epoch). - `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. - object — Details about the brand template. - `type` 'brand_template', required - `brand_template` BrandTemplateSummary, required — An object representing a brand template with associated metadata. - `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). - `continuation` string — If the success response contains a continuation token, the folder contains more items you can list. You can use this token as a query parameter and retrieve more items from the list, for example `/v1/folders/{folderId}/items?continuation={continuation}`. To retrieve all the items in a folder, you might need to make multiple requests. ## Other responses - `400` — Bad Request - `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)