---
title: "GET /v1/designs/{designId}/analytics/views-over-time"
method: GET
path: "/v1/designs/{designId}/analytics/views-over-time"
tags: ["analytics"]
---

# GET /v1/designs/{designId}/analytics/views-over-time

`GET /v1/designs/{designId}/analytics/views-over-time`

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

<Availability>
To use this API, your integration must act on behalf of a user who is a member of a [Canva Enterprise](https://www.canva.com/enterprise/) organization.
</Availability>

Lists the view counts over time for a design.

Each response item represents one time bucket.

## Path parameters

- `designId` string, required

## Query parameters

- `start_time` integer
- `end_time` integer
- `timezone` string
- `limit` integer
- `continuation` string

## Response `200`

OK

- GetDesignAnalyticsViewsOverTimeResponse — Successful response from a `getDesignAnalyticsViewsOverTime` request.
  - `items` ViewsAtTime[], required — The list of time buckets.
    - `count` integer, required — The number of views in this bucket.
    - `bucket_start_at` integer, required — When this time bucket starts, as a Unix timestamp (in seconds since the Unix Epoch).
  - `continuation` string — If the success response contains a continuation token, there are more time buckets you can list. You can use this token as a query parameter and retrieve more time buckets from the list, for example `/v1/designs/{designId}/analytics/views-over-time?continuation={continuation}`. To retrieve all time buckets, you might need to make multiple requests.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `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)