> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [/docs/api/analytics/openapi.json](/docs/api/analytics/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# Analytics: Get campaign performance

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

One endpoint of [Analytics](/docs/api/analytics.md). Authentication, workspaces and errors: [/docs.md](/docs.md).

## Get campaign performance

`GET /v1/analytics/campaign-performance` - operationId `analytics.get-campaign-performance`

| Permission | Rate limit |
| --- | --- |
| Campaigns view | 12,000 requests a minute per API key |

Returns send, open, click, reply and bounce metrics for one campaign or the whole workspace over a window. The
window totals are in `metrics`, and `rows` split them by `groupBy`.

Pass `from` and `to`, both inclusive. With `campaignId` you can leave both out to get the campaign to
date: from its first send or first imported day, whichever is earlier, to today, at most 3660 days. The response's
`from` and `to` hold the window used. A window you set is at most 366 days, or 3660 days with
`groupBy=campaign`.
`channel` is `email` (the default) or `linkedin`. The `linkedin` channel needs `campaignId`.

`groupBy` is one of:

- `day` (the default): one row per day.
- `step`: one row per sequence step. Needs `campaignId`.
- `segment`: one row per segment. Needs `campaignId`. On email, each row has `steps`: the segment's email steps in order, each with its sends, contacted, replies, interested replies, bounces and clicks, and one entry per version in `variants`. Opens and unsubscribes are not split by step and read 0. `steps` is omitted for a window over 90 days.
- `sender_route`: email only, needs `campaignId`. One row per sender rule a contact's first email went out under: each provider rule (`key` is the provider, `label` its name), `everyone_else`, and `not_routed` for sends with no rules or with sender routing off. `routeKey` equals `key`.
- `language`: needs `campaignId`. One row per language the campaign's emails went out in, sorted by sends, with `unknown` last for sends that recorded no language. The LinkedIn channel has no language rows.
- `campaign`: email only, without `campaignId`. One row per campaign with email activity in the window, with `campaignId` on each row.

In `sender_route` rows, each contact counts in one row only, with its sends, contacted, repliers, interested
replies and bounces. Opens, clicks, unsubscribes, `bounceBreakdown`, opportunities and meetings are not split
by route, so they read 0 or are left out on the rows. A `language` row holds sends, contacted, replies,
interested and the reply rate over contacted. A reply counts in the language of the send it answers. Opens, clicks
and bounces are not split by language. For both, the window `metrics` are the campaign's `groupBy=day`
totals, so the rows need not add up to them.
A `campaign` row with a `timeZone` other than UTC matches that campaign's own `groupBy=day` read in
the same zone, so one call returns lifetime numbers for every campaign. With UTC, the rows add up UTC days, so a
contact active on several days counts once per day. `campaign` rows leave out the opportunity, meeting and
`bounceBreakdown` fields, and the window `metrics` add up the rows.
For per-inbox numbers, call `GET /v1/analytics/deliverability` with `groupBy=inbox`.

Days are UTC calendar days unless `timeZone` is an IANA zone other than UTC. Then rows count that zone's days,
from its midnight on `from` to its midnight after `to`, and the window `metrics` add up the day rows.
For one campaign, unique opens and unique clicks still count each contact once over the whole window. Imported
history and days before 2026-08-24 stay on UTC days. A segment row's opens and unsubscribes also stay on UTC days.

`openCount`, `uniqueOpenCount` and `openRate` count human opens. Opens are an estimate and a floor,
so use reply rate as the headline number. `clickCount` counts human clicks on links Kenso tracks.
The opportunity fields appear only when the workspace has the `opportunities` feature and you have Accounts
view.

To read one campaign several ways in one call, pass `views` with `campaignId`, `from` and
`to`. The response is the `groupBy=day` email read, and `views` in it holds one more read per name,
each equal to what its own call returns:

- `previous`: the same read over the window of the same length that ends the day before `from`.
- `linkedin`: `channel=linkedin` by day. `linkedin_previous`: the same over the previous window.
- `segment`, `language`, `sender_route`: that `groupBy` on email over the window.

A view that could not be read is left out and named in `views.errors`, and the rest of the response stands.

Errors:

- `400 validation_failed`: the window, `groupBy`, `channel`, `timeZone` or `views` is not valid, or the `groupBy`, channel or `views` needs a `campaignId`.
- `404 not_found`: the campaign is not in the workspace.

Requires Campaigns view.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/analytics/GET/v1/analytics/campaign-performance)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `campaignId` | query | integer (int64) | no | The campaign to report on. Omitted reports the whole workspace, on the email channel only. |
| `from` | query | string (date-time) | no | First day of the window, an ISO 8601 date such as `2026-10-01`. Send it with `to`, or leave both out with `campaignId` to report the campaign to date. |
| `to` | query | string (date-time) | no | Last day of the window, inclusive, an ISO 8601 date on or after `from`. The window spans at most 366 days, or 3660 days when `groupBy` is `campaign`. |
| `groupBy` | query | string | no | How to split the rows: `day` (default), `step`, `segment`, `sender_route`, `language` or `campaign`. Every value except `day` and `campaign` needs `campaignId`, and `campaign` takes none. |
| `channel` | query | string | no | The channel to report: `email` (default) or `linkedin`. `linkedin` needs `campaignId`, and the `groupBy` values `campaign` and `sender_route` work on email only. |
| `timeZone` | query | string | no | IANA time zone whose calendar days the window and day rows use, such as `America/New_York`. Default UTC. |
| `views` | query | string | no | Extra reads of the same campaign to return in `views`, comma-separated: `previous`, `linkedin`, `linkedin_previous`, `segment`, `language` and `sender_route`. Needs `campaignId`, `from` and `to`, with `groupBy` `day` and `channel` `email` (the defaults). |
| `Ken-Version` | header | string, one of: 2026-11-02, 1.1 | no | The API version, a date in `YYYY-MM-DD` form. `1.1` is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and `404` where the path exists only in this version. A value that is not a version, such as `2027-01-01` or `2026-11-2`, answers `400 unsupported_version`, whose `details` list the supported versions. |
| `X-Ken-Workspace-Id` | header | integer (int64) | no | The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers `400 workspace_required`. A workspace you are not a member of answers `404 not_found`. |

### Response 200

`data` is a `CampaignPerformance`.

| Field | Type | Description |
| --- | --- | --- |
| `campaignId` | integer (int64) | The campaign the numbers cover. Omitted when the call covered every campaign in the workspace. |
| `from` | string (date-time) | The start of the window, in UTC. |
| `to` | string (date-time) | The end of the window, in UTC. |
| `timeZone` | string | The IANA time zone the call asked for. Omitted when none was sent, and days are then UTC days. |
| `groupBy` | string | How `rows` are grouped: `day`, `step`, `segment`, `sender_route`, `language` or `campaign`. |
| `channel` | string | The channel the numbers cover: `email` or `linkedin`. |
| `metrics` | CampaignPerformanceMetrics | The window's totals. For a campaign imported from another tool, they can include bounces and unsubscribes that belong to no day, so they can exceed the sum of the rows. |
| `rows` | array of CampaignPerformanceRow | One row per group, such as one per day for `groupBy=day`. |
| `views` | CampaignPerformanceViews | The extra reads the call asked for with `views`. Omitted when it asked for none. |

### Request

```bash
curl -X GET "https://api.ken.so/v1/analytics/campaign-performance" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"
```

### Example response

```json
{
  "success": true,
  "data": {
    "campaignId": 812,
    "from": "2026-09-23T15:02:11Z",
    "to": "2026-09-23T15:02:11Z",
    "timeZone": "string",
    "groupBy": "day",
    "channel": "email",
    "metrics": {
      "sentCount": 1,
      "deliveredCount": 1,
      "bounceCount": 1,
      "openCount": 1,
      "uniqueOpenCount": 1,
      "clickCount": 1,
      "uniqueClickCount": 1,
      "botClickCount": 1,
      "machineOpenCount": 1,
      "opensTracked": true,
      "clicksTracked": true,
      "replyCount": 1,
      "unsubscribeCount": 1,
      "interestedCount": 1,
      "contactedCount": 1,
      "inviteCount": 1,
      "acceptedCount": 1,
      "messageCount": 1,
      "deliveryRate": 0.5,
      "openRate": 0.5,
      "clickRate": 0.5,
      "replyRate": 0.5,
      "bounceRate": 0.5,
      "bounceBreakdown": {
        "hardCount": 1,
        "softCount": 1,
        "unknownCount": 1,
        "byReason": {
          "key": 1
        }
      },
      "opportunitiesCreated": 1,
      "pipelineAmount": 0.5,
      "wonAmount": 0.5,
      "wonCount": 1,
      "meetingsBooked": 1
    },
    "rows": [
      {
        "key": "string",
        "date": "string",
        "stepOrder": 1,
        "segmentId": 812,
        "campaignId": 812,
        "label": "string",
        "routeKey": "string",
        "metrics": {
          "sentCount": 1,
          "deliveredCount": 1,
          "bounceCount": 1,
          "openCount": 1,
          "uniqueOpenCount": 1,
          "clickCount": 1,
          "uniqueClickCount": 1,
          "botClickCount": 1,
          "machineOpenCount": 1,
          "opensTracked": true,
          "clicksTracked": true,
          "replyCount": 1,
          "unsubscribeCount": 1,
          "interestedCount": 1,
          "contactedCount": 1,
          "inviteCount": 1,
          "acceptedCount": 1,
          "messageCount": 1,
          "deliveryRate": 0.5,
          "openRate": 0.5,
          "clickRate": 0.5,
          "replyRate": 0.5,
          "bounceRate": 0.5,
          "bounceBreakdown": {
            "hardCount": 1,
            "softCount": 1,
            "unknownCount": 1,
            "byReason": {}
          },
          "opportunitiesCreated": 1,
          "pipelineAmount": 0.5,
          "wonAmount": 0.5,
          "wonCount": 1,
          "meetingsBooked": 1
        },
        "variants": [
          {
            "variant": "a",
            "sentCount": 1,
            "acceptedCount": 1,
            "replyCount": 1,
            "failedCount": 1,
            "acceptRate": 0.5
          }
        ],
        "steps": [
          {
            "stepOrder": 1,
            "metrics": {},
            "variants": []
          }
        ],
        "notesWaiting": 1,
        "notesSkippedFreeAccount": 1,
        "notesFailed": 1
      }
    ],
    "views": {
      "previous": {},
      "linkedin": {},
      "linkedinPrevious": {},
      "segment": {},
      "language": {},
      "senderRoute": {},
      "errors": [
        {
          "view": "previous",
          "code": "internal_error",
          "message": "string"
        }
      ]
    }
  }
}
```

## Types

Each named type the tables above use, nested ones included.

### CampaignPerformanceMetrics

Sending results for the window or for one row. Rates are fractions from 0 to 1, rounded to 4 decimals, and 0 when the base is 0.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `sentCount` | integer (int32) | no | Messages sent. On LinkedIn, invites plus messages and InMails. |
| `deliveredCount` | integer (int32) | no | Emails delivered: sent and not bounced. |
| `bounceCount` | integer (int32) | no | Emails that bounced. |
| `openCount` | integer (int32) | no | Human opens, counting repeat opens. |
| `uniqueOpenCount` | integer (int32) | no | Human opens, without repeat opens. |
| `clickCount` | integer (int32) | no | Human link clicks, counting repeat clicks. |
| `uniqueClickCount` | integer (int32) | no | Human link clicks, without repeat clicks. |
| `botClickCount` | integer (int32) | no | Clicks from bots and link scanners. Not part of `clickCount` or `clickRate`. |
| `machineOpenCount` | integer (int32) | no | Contacts whose every open in the window was a machine open: Apple Mail Privacy Protection, a crawler, or an open within a minute of the send, such as a security scanner fetching the email. Not part of `openCount`, `uniqueOpenCount` or `openRate`. Present on the email window totals and step rows, and omitted elsewhere. Treat opens as an estimate: image blocking hides some, and Kenso can tell apart only some machine opens. |
| `opensTracked` | boolean | no | Whether Kenso records this campaign's opens. `false` means do not read `openRate` as real: a plain-text campaign (Send as plain text on) carries no open pixel, and a campaign with Track opens off records none. Steps kept as HTML (a drawn letter, a Studio email, an image, a video or a provider-built message) can still carry the pixel, so a plain-text campaign's opens are partial rather than none. It reflects the campaign's settings now, not the settings in force when each email went out: a campaign switched to plain text part way through reads `false` for its earlier HTML days too, and one switched back reads `true` for its plain-text days. Opens imported from another tool are the vendor's own, so an imported campaign's `opensTracked` is omitted (unknown) wherever it would read `false`. A workspace past its billing grace sends with no open pixel from then on, while its earlier emails carried one, so its opens are partly tracked: `opensTracked` is omitted (never `true`, and not `false`, which says none were recorded). On an email campaign's window totals, rows, and a segment row's steps and versions, and on `groupBy=campaign` rows. Omitted on `language` and `sender_route` rows (they split no opens), when the call covers more than one campaign, on LinkedIn, and when it is unknown. Wherever it is omitted, opens are partly tracked or unknown: read `openRate` as a floor, never as a real rate or as zero. On one campaign's own figures (a one-campaign email read, or a `groupBy=campaign` row) that means the workspace is past its billing grace, the campaign was imported, or the read failed. A figure that spans campaigns (the window totals, and every row of a read with no `campaignId` other than `groupBy=campaign` rows) has no value of its own and is unknown: check the `groupBy=campaign` rows, or one campaign's read, before relying on its opens. |
| `clicksTracked` | boolean | no | Whether Kenso records this campaign's link clicks. `false` means do not read `clickCount` or `clickRate` as real: the campaign has Send as plain text on, and since 15 Nov 2026 a plain-text email shows each link's own address with no click-tracking link. Steps kept as HTML (a drawn letter, a Studio email, an image, a video or a provider-built message) and earlier emails still count clicks, so its clicks are partial, not none. `true` otherwise, including provider tracks that send plain text to Google leads only. It does not reflect Track link clicks off (`trackClicks`). From the campaign's settings now, on the same metrics as `opensTracked`, and omitted where that is omitted for the whole call, past billing grace (no click link from then on), and on an imported campaign that would read `false` (vendor clicks): read `clickRate` as a floor there. |
| `replyCount` | integer (int32) | no | Contacts who replied. |
| `unsubscribeCount` | integer (int32) | no | Unsubscribes. |
| `interestedCount` | integer (int32) | no | Replies classified as interested. |
| `contactedCount` | integer (int32) | no | Distinct contacts sent at least one message. |
| `inviteCount` | integer (int32) | no | LinkedIn only: connection invites sent. Omitted on email. |
| `acceptedCount` | integer (int32) | no | LinkedIn only: connection invites accepted. Omitted on email. |
| `messageCount` | integer (int32) | no | LinkedIn only: messages and InMails sent. Omitted on email. |
| `deliveryRate` | number (double) | no | Delivery rate: `deliveredCount` divided by `sentCount`. |
| `openRate` | number (double) | no | Open rate: `uniqueOpenCount` divided by `deliveredCount`, or by `sentCount` when nothing counts as delivered. |
| `clickRate` | number (double) | no | Click rate: `uniqueClickCount` divided by the contacts reached, or by `sentCount` when that count is 0. |
| `replyRate` | number (double) | no | Reply rate: `replyCount` divided by the contacts reached, or by `sentCount` when that count is 0. |
| `bounceRate` | number (double) | no | Bounce rate: `bounceCount` divided by `sentCount`. |
| `bounceBreakdown` | CampaignPerformanceBounceBreakdown | no | Bounces split by type and reason. Present on the window totals and on segment rows when the window has a classified bounce, and omitted otherwise. Its total need not equal `bounceCount`. |
| `opportunitiesCreated` | integer (int32) | no | Opportunities created in the window from this campaign, or from any campaign when the call named none, counted on the day each was created. Omitted on segment rows and on LinkedIn. This field and the three after it are omitted unless the workspace has the `opportunities` feature and the caller has Accounts view. |
| `pipelineAmount` | number (double) | no | The current open amount of those opportunities, in the workspace's currency. |
| `wonAmount` | number (double) | no | The current won amount of those opportunities, in the workspace's currency. |
| `wonCount` | integer (int32) | no | How many of those opportunities are won now. |
| `meetingsBooked` | integer (int32) | no | Meetings booked in the window from this campaign, or from any campaign when the call named none. A moved meeting counts once. Omitted on segment rows and on LinkedIn. |

### CampaignPerformanceRow

One group of the results, such as one day or one step.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `key` | string | no | The group's value: the date for `day`, the step for `step`, the segment id for `segment`, the campaign id for `campaign`, the language for `language`, or the route for `sender_route`. |
| `date` | string | no | Day rows only: the date as `YYYY-MM-DD`. |
| `stepOrder` | integer (int32) | no | Step rows only: the step's position in the sequence. |
| `segmentId` | integer (int64) | no | The segment the row covers, on segment rows and on LinkedIn step rows. |
| `campaignId` | integer (int64) | no | Campaign rows only: the campaign the row counts. |
| `label` | string | no | The row's display name: the segment name on segment rows, and the rule name on sender route rows. |
| `routeKey` | string | no | Sender route rows only, equal to `key`: the sender rule's provider, `everyone_else` or `not_routed`. |
| `metrics` | CampaignPerformanceMetrics | no | The row's results. |
| `variants` | array of CampaignPerformanceVariant | no | LinkedIn step rows only: one entry per version, `a` to `d`, for comparing versions of the invite. |
| `steps` | array of CampaignPerformanceStep | no | Email segment rows only: the segment's email steps by `stepOrder`, each with its versions. Omitted when the window is over 90 days or the segment has no step counts. |
| `notesWaiting` | integer (int32) | no | LinkedIn step rows only: AI invite notes requested or waiting for approval. |
| `notesSkippedFreeAccount` | integer (int32) | no | LinkedIn step rows only: invites sent without a note because the LinkedIn account is not Premium. |
| `notesFailed` | integer (int32) | no | LinkedIn step rows only: invite notes that failed to generate. |

### CampaignPerformanceViews

The extra reads of a call with `views`, one field per view it asked for. Each is the response its own call returns, with its own `from`, `to`, `groupBy` and `channel`, and no `views` of its own. A view the call did not ask for is omitted, and so is one that could not be read, which `errors` names.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `previous` | CampaignPerformance | no | View `previous`: the email read by day over the window of the same length that ends the day before `from`. |
| `linkedin` | CampaignPerformance | no | View `linkedin`: the LinkedIn channel by day over the window. |
| `linkedinPrevious` | CampaignPerformance | no | View `linkedin_previous`: the LinkedIn channel by day over the previous window. |
| `segment` | CampaignPerformance | no | View `segment`: the email read with `groupBy=segment` over the window. |
| `language` | CampaignPerformance | no | View `language`: the email read with `groupBy=language` over the window. |
| `senderRoute` | CampaignPerformance | no | View `sender_route`: the email read with `groupBy=sender_route` over the window. |
| `errors` | array of CampaignPerformanceViewError | no | The views that could not be read. Omitted when every view was. |

### CampaignPerformanceBounceBreakdown

Bounces split by type and reason.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `hardCount` | integer (int32) | no | Hard bounces: the address is permanently refused. |
| `softCount` | integer (int32) | no | Soft bounces: a temporary failure, such as a full mailbox. |
| `unknownCount` | integer (int32) | no | Bounces with no type signal. `hardCount`, `softCount` and `unknownCount` add up to every classified bounce. |
| `byReason` | map of integer (int32) | no | Bounce counts keyed by reason, such as `invalidRecipient` or `policyBlocked`. Only reasons with a count above 0 appear. |

### CampaignPerformanceVariant

Results for one version of a LinkedIn invite step.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `variant` | string | no | The version: `a`, `b`, `c` or `d`. |
| `sentCount` | integer (int32) | no | Invites sent. |
| `acceptedCount` | integer (int32) | no | Invites accepted. |
| `replyCount` | integer (int32) | no | Contacts who replied. |
| `failedCount` | integer (int32) | no | Invites that failed to send. |
| `acceptRate` | number (double) | no | Acceptance rate: `acceptedCount` divided by `sentCount`, as a fraction from 0 to 1. 0 when nothing was sent. |

### CampaignPerformanceStep

Results for one email step of a segment. Opens, unsubscribes, bot clicks, opportunities and meetings are not split by step, so they read 0 or are omitted.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `stepOrder` | integer (int32) | no | The step's position in the segment's sequence. |
| `metrics` | CampaignPerformanceMetrics | no | The step's results. |
| `variants` | array of CampaignPerformanceStepVariant | no | One entry per version of the step, `a` to `d`, sorted. Empty when the step has none. |

### CampaignPerformance

A campaign's or the workspace's sending results over a window, as totals and grouped rows.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `campaignId` | integer (int64) | no | The campaign the numbers cover. Omitted when the call covered every campaign in the workspace. |
| `from` | string (date-time) | no | The start of the window, in UTC. |
| `to` | string (date-time) | no | The end of the window, in UTC. |
| `timeZone` | string | no | The IANA time zone the call asked for. Omitted when none was sent, and days are then UTC days. |
| `groupBy` | string | no | How `rows` are grouped: `day`, `step`, `segment`, `sender_route`, `language` or `campaign`. |
| `channel` | string | no | The channel the numbers cover: `email` or `linkedin`. |
| `metrics` | CampaignPerformanceMetrics | no | The window's totals. For a campaign imported from another tool, they can include bounces and unsubscribes that belong to no day, so they can exceed the sum of the rows. |
| `rows` | array of CampaignPerformanceRow | no | One row per group, such as one per day for `groupBy=day`. |
| `views` | CampaignPerformanceViews | no | The extra reads the call asked for with `views`. Omitted when it asked for none. |

### CampaignPerformanceViewError

A view of a call with `views` that could not be read.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `view` | string | no | The view, as named in the request: `previous`, `linkedin`, `linkedin_previous`, `segment`, `language` or `sender_route`. |
| `code` | string | no | The error code the view's own call returns, such as `internal_error`. |
| `message` | string | no | What went wrong, for a person to read. |

### CampaignPerformanceStepVariant

Results for one version of an email step of a segment.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `variant` | string | no | The version: `a`, `b`, `c` or `d`. |
| `metrics` | CampaignPerformanceMetrics | no | The version's results, counted the same way as the step's. |
