Credit savings
The Credit savings endpoints of the Kenso API.
Return what Kenso did free for the workspace, at Clay's prices
/v1/credits/savingscredit-savings.getThe window is UTC days, both inclusive: to defaults to today and from to the first of to's month, at most 366 days. Items: ken_db_email, email_verification, enrichment_person, enrichment_company, enrichment_tech_stack and website_page (always all six, in this order), then launch_offer when the launch offer covered work. Kenso Search people are recorded but left out while Clay's people search is free. Each item is its units and their value in cents at Clay's unit price (unitPriceUsdMicros, millionths of a dollar); totalUsdCents is the sum of the items, and each item the sum of its rows in credit-savings-rows.list. lifetime is every day since the first one recorded. An exempt workspace's savings are only its free work, never its not-charged shadow lines. 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
400 workspace_required).Response 200
data is a CreditSavingsModel.
clay.launch_offer when the launch offer covered work.curl -X GET "https://api.ken.so/v1/credits/savings" \ -H "Authorization: Bearer $KEN_API_KEY" \ -H "Ken-Version: 2026-11-02" \ -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
{
"success": true,
"data": {
"from": "2026-09-23",
"to": "2026-09-23",
"priceSource": "string",
"pricesCheckedOn": "2026-09-23",
"totalUsdCents": 1,
"items": [
{
"item": "ken_db_email",
"units": 1,
"unitPriceUsdMicros": 1,
"valueUsdCents": 1
}
],
"lifetime": {
"since": "2026-09-23",
"totalUsdCents": 1
}
}
}