---
title: "Retrieve performance for an asset"
method: GET
path: "/assets/{asset_id}/performance"
tags: ["Assets"]
---

# Retrieve performance for an asset

`GET /assets/{asset_id}/performance`

## Request

- Base URL: `https://enterprise.knak.io/api/published/v1`
- URL: `https://enterprise.knak.io/api/published/v1/assets/{asset_id}/performance`
- Auth: none declared
- TypeScript: <https://skmtc.dev/knak/apis/knak-enterprise-api/docs/assets/:asset_id/performance/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve send and engagement totals for an asset from your connected marketing automation platform. Every metric is null until the asset has been sent and its performance data collected.

Requires the performance data feature on your Knak plan.

## Path parameters

- `asset_id` string, required

## Response `200`

OK

- AssetPerformance
  - `data` object
    - `asset_id` string, required
    - `last_sent` string, date-time, nullable, required
    - `sent` integer, nullable, required
    - `delivered` integer, nullable, required
    - `opened` integer, nullable, required
    - `clicked` integer, nullable, required
    - `unique_clicks` integer, nullable, required
    - `bounced` integer, nullable, required
    - `unsubscribed` integer, nullable, required
    - `rates` object, required: Fractions from 0 to 1.
      - `delivery` number, nullable, required: Delivered divided by sent.
      - `open` number, nullable, required
      - `click` number, nullable, required

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden - performance data is not part of your company's plan.
- `404`: Not Found - the asset does not exist or is outside your brands.
- `default`: Unexpected server error.

---

[API](https://skmtc.dev/knak/apis/knak-enterprise-api.md) - [All operations](https://skmtc.dev/knak/apis/knak-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/knak/apis/knak-enterprise-api/revisions/31d2c94edfcc?raw)