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

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

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

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

Gets the aggregated analytics for a design.

The response includes total views, unique viewers, and view duration metrics.

## Path parameters

- `designId` string, required

## Response `200`

OK

- GetDesignAnalyticsResponse — Aggregated analytics metrics for a design.
  - `average_view_duration_seconds` integer — The average view duration in seconds.
  - `total_view_duration_seconds` integer — The total view duration in seconds.
  - `unique_view_count` integer, required — The number of unique viewers.
  - `total_view_count` integer, required — The total number of views.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `default` — Error Response

## Changes

- **2026-08-28** `f32aa6ee029d` — 6 warning
  - added the new `design_generation_rejected` enum value to the `code` response property for the response status `400`
  - added the new `design_generation_rejected` enum value to the `code` response property for the response status `401`
  - added the new `design_generation_rejected` enum value to the `code` response property for the response status `403`
  - added the new `design_generation_rejected` enum value to the `code` response property for the response status `404`
  - …2 more
- **2026-08-27** `e5ffb199a510` — 12 warning
  - added the new `domain_restricted` enum value to the `code` response property for the response status `400`
  - added the new `domain_restricted` enum value to the `code` response property for the response status `401`
  - added the new `domain_restricted` enum value to the `code` response property for the response status `403`
  - added the new `domain_restricted` enum value to the `code` response property for the response status `404`
  - …8 more

[Change history](https://skmtc.dev/canva/apis/canva-connect-api/changes/v1/designs/:designId/analytics/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-service-production.skmtc.workers.dev/v1/apis/canva/canva-connect-api/revisions/f32aa6ee029d/schema)