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

# GET /v1/designs/{designId}/pages

`GET /v1/designs/{designId}/pages`

<Warning>

This API is currently provided as a preview. Be aware of the following:

- There might be unannounced breaking changes.
- Any breaking changes to preview APIs won't produce a new [API version](https://www.canva.dev/docs/connect/versions/).
- Public integrations that use preview APIs will not pass the review process, and can't be made available to all Canva users.

</Warning>

Lists metadata for pages in a design, such as page-specific thumbnails.

For the specified design, you can provide `offset` and `limit` values to specify the range of pages to return.

NOTE: Some design types don't have pages (for example, Canva docs).

## Path parameters

- `designId` string, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

OK

- GetDesignPagesResponse — Successful response from a `getDesignPages` request.
  - `items` DesignPage[], required — The list of pages.
    - `id` string — The ID of the page. This ID is unique within the design and can be used to correlate a page with per-page data from other APIs. Some designs might not have page IDs, in which case this property is omitted.
    - `index` integer, required — WARNING: This property is deprecated. Use `page_number` instead, which returns an identical value. The index of the page in the design. The first page in a design has the index value `1`.
    - `page_number` integer, required — The 1-based page number within the design. The first page in a design has the value `1`.
    - `dimensions` PageDimensions — The dimensions of a design page, if it is bounded. Design pages for non-bounded designs like Whiteboards and Docs will not include this property.
      - `width` number, double, required — The width of the design page in pixels.
      - `height` number, double, required — The height of the design page in pixels.
    - `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.
    - `design_type` 'doc' | 'email' | 'presentation' | 'sheet' | 'whiteboard' | 'custom' | 'unknown', 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
- `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)