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

# Credit savings rows

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

Credits pay for work in Kenso, such as finding emails, AI qualification and personalization, campaign builds, and Kenso inboxes, domains and LinkedIn accounts. Every amount in this section is in millicredits: 1 credit is 1,000 millicredits and costs $0.02. Read the balance and estimate a job before you start it, then read the ledger to see where the credits went. A white-label client workspace shares its parent workspace's balance.

Workspace and account. 1 endpoint under `https://api.ken.so`. Every request sends `Authorization: Bearer <your API key>` and `Ken-Version: 2026-11-02`: see [Authentication](/docs/authentication.md), [Workspaces](/docs/workspaces.md) and [Errors](/docs/errors.md). OpenAPI for this resource only: [/docs/api/credit-savings-rows/openapi.json](/docs/api/credit-savings-rows/openapi.json).

- `GET /v1/credits/savings/rows` - List Free with Kenso savings rows (`credit-savings-rows.list`): [/docs/api/credit-savings-rows/list.md](/docs/api/credit-savings-rows/list.md)

## List Free with Kenso savings rows

`GET /v1/credits/savings/rows` - operationId `credit-savings-rows.list`

| Permission | Rate limit |
| --- | --- |
| Any workspace member except a Network member | 12,000 requests a minute per API key |

Lists the daily rows behind the Free with Kenso savings: one row per UTC day, item and campaign. Rows come newest
day first, then by item and campaign. Work outside a campaign has no `campaignId`.

The window and items are the same as in `GET /v1/credits/savings`, and each of its items adds up these
rows. Filter by `item` to get one item's rows. `ken_search_person` has no rows while Clay prices it at
$0. `limit` is from 1 to 200, and the default is 50.

Errors:

- `400 validation_failed`: `item`, `limit` or `cursor` is invalid, `from` is after
`to`, or the window is longer than 366 days.
- `404 not_found`: the caller is a Client seat, or the workspace is a white-label client workspace.

Open to any workspace member.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/credits/GET/v1/credits/savings/rows)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `from` | query | string (date) | no | The first UTC day of the window, inclusive, as `YYYY-MM-DD`. Defaults to the first day of `to`'s month. |
| `to` | query | string (date) | no | The last UTC day of the window, inclusive, as `YYYY-MM-DD`. Defaults to today. |
| `item` | query | string | no | Only the rows of one kind of free work, such as `ken_db_email`. Omitted returns every kind. |
| `limit` | query | integer (int32) | no | The page size, from 1 to 200. The default is 50. |
| `cursor` | query | string | no | The `nextCursor` of the previous page. Omit it for the first page. |
| `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 list of `CreditSavingsRow`. Each item has these fields. The response also carries `pagination`.

| Field | Type | Description |
| --- | --- | --- |
| `date` | string (date) | The UTC day of the work. |
| `item` | string, one of: ken_db_email, email_verification, enrichment_person, ken_search_person, website_page, launch_offer, enrichment_company, enrichment_tech_stack | The kind of free work, such as `ken_db_email`. |
| `campaignId` | integer (int64) | The campaign the work was for. Omitted for work outside a campaign. |
| `campaignName` | string | The campaign's name. Omitted for work outside a campaign. |
| `units` | integer (int64) | How many units of this work Kenso did free that day. |
| `valueUsdCents` | integer (int64) | The value of the units, in US cents. |

### Request

```bash
curl -X GET "https://api.ken.so/v1/credits/savings/rows?limit=50" \
  -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": [
    {
      "date": "2026-09-23",
      "item": "ken_db_email",
      "campaignId": 812,
      "campaignName": "string",
      "units": 1,
      "valueUsdCents": 1
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6ODE1fQ",
    "hasMore": true,
    "total": 1,
    "totalCount": 1,
    "isTotalCapped": true
  }
}
```

All resources: [/docs.md](/docs.md).
