Credit savings rows
The Credit savings rows endpoints of the Kenso API.
List the daily rows behind the workspace's Free with Kenso savings
GET
/v1/credits/savings/rowscredit-savings-rows.listOne row per UTC day, item and campaign (campaignId absent outside a campaign), newest day first, then item and campaign; cursor paginated. Same window and items as credit-savings.get, whose items each sum these rows. Optional item keeps one item's rows; ken_search_person has none while Clay prices it at $0. Any member of the workspace except a Client seat; a Client seat and a white-label client workspace get 404 not_found. Read only.
Parameters
Name
In
Type
Required
Description
From
In: query
string (date)
optional
First UTC day, inclusive. Defaults to the first of
to's month.To
In: query
string (date)
optional
Last UTC day, inclusive. Defaults to today.
Item
In: query
string
optional
One item, e.g.
ken_db_email; every item when absent.Limit
In: query
integer (int32)
optional
Page size, 1-200 (default 50).
Cursor
In: query
string
optional
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
X-Ken-Workspace-Id
In: header
integer (int64)
optional
Workspace to act in. Required when your credential can reach more than one workspace (otherwise
400 workspace_required).Response 200
data is a list of CreditSavingsRowModel. Each item has these fields. The response also carries pagination.
Field
Type
Description
date
string (date)
item
string, one of: ken_db_email, email_verification, enrichment_person, ken_search_person, website_page, launch_offer, enrichment_company, enrichment_tech_stack
campaignId
integer (int64)
Absent for work outside a campaign.
campaignName
string
units
integer (int64)
valueUsdCents
integer (int64)
Request
curl -X GET "https://api.ken.so/v1/credits/savings/rows" \ -H "Authorization: Bearer $KEN_API_KEY" \ -H "Ken-Version: 2026-11-02" \ -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 200
{
"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,
"isTotalCapped": true
}
}