Kenso
Get early access

Credit estimates

Estimate what a campaign, a build, infrastructure or new accounts will cost in credits. Nothing is charged.

Workspace and credits1 endpointKen-Version: 2026-11-02AuthenticationWorkspacesErrors

Estimate the credits a campaign, a build, an infra purchase, adding accounts, importing leads or places searches need

POST/v1/credits/estimatescredit-estimates.create

Try it on developer.ken.so

Computes only; nothing is charged or reserved. kind is campaign (target leads, steps, personalization; defaults come from campaignId), build (a typical campaign build, or 0 when the free monthly build is left), infra (items; monthly items count their first month upfront) or accounts (accountCount, 1-1,000: an estimated 12 credits of account research per account, metered per run, plus about 6 valid committee emails, charged only when found) or leads (leadCount, 1-1,000,000: 1.45 credits a lead, from about 3 rows qualified, 1 valid email found and 1 personalization) or places (pages, 0-1,000, at 1 credit a search page of up to 200 places, and opens, 0-100,000, free for the first 500 a workspace a day and then 0.05 credits an open; send at least one above 0). Fields that do not belong to the kind are rejected. Campaign, build, accounts, leads and places estimates are measured against available credits, infra against the whole balance, and its inbox and domain lines against inboxDomainEligibleMillicredits (infra only: free and bonus credits cannot pay them). Any member of the workspace.

Parameters

Name
In
Type
Required
Description
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).

Request body

application/json, optional.

Field
Type
Required
Description
kind
string
optional
campaign, build, infra, accounts, leads or places.
campaignId
integer (int64)
optional
Campaign only: read target leads, step count and personalization from this campaign.
targetLeads
integer (int32)
optional
Campaign only: finished leads, 1-1,000,000. Required unless the campaign's contact limit is below 1,000,000 (the default, which is not read as a target).
sequenceSteps
integer (int32)
optional
Campaign only: sequence steps, 1-50 (default: the campaign's, else 3).
personalization
boolean
optional
Campaign only: whether leads are personalized (default: the campaign's, else true).
items
array of CreditEstimateInfraItemRequest
optional
Infra only: 1-50 purchases.
accountCount
integer (int32)
optional
Accounts only: accounts to add, 1-1,000.
leadCount
integer (int32)
optional
Leads only: leads to import, 1-1,000,000.
pages
integer (int32)
optional
Places only: search pages of up to 200 places, 0-1,000. Send pages or opens above 0.
opens
integer (int32)
optional
Places only: detail, reviews or photos opens, 0-100,000. The first 500 a workspace a UTC day are free.

Response 200

data is a CreditEstimateModel.

Field
Type
Description
object
string
Always credit_estimate.
totalMillicredits
integer (int64)
Credits needed now (infra counts its first month upfront).
monthlyRecurringMillicredits
integer (int64)
Credits the purchase adds to the monthly infra reservation. 0 for campaigns, builds and accounts.
lines
array of CreditEstimateLineModel
availableMillicredits
integer (int64)
Credits the estimate is measured against: available credits for campaigns, builds and accounts, the whole balance for infra.
sufficient
boolean
Whether the workspace can cover the estimate now (always true when exempt).
freeBuild
boolean
Build estimates only: whether the free monthly build covers it.
inboxDomainEligibleMillicredits
integer (int64)
Infra estimates only: the credits that may pay the inbox and domain lines (the balance minus free and bonus credits, which cannot). sufficient is false when these lines cost more, even when availableMillicredits covers the total.
Request
curl -X POST "https://api.ken.so/v1/credits/estimates" \
  -H "Authorization: Bearer $KEN_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "string",
  "campaignId": 812,
  "targetLeads": 1,
  "sequenceSteps": 1,
  "personalization": true,
  "items": [
    {
      "action": "string",
      "quantity": 1,
      "registrarPriceUsd": 0.5,
      "renewalPriceUsd": 0.5
    }
  ],
  "accountCount": 1,
  "leadCount": 1,
  "pages": 1,
  "opens": 1
}'
Response 200
{
  "success": true,
  "data": {
    "object": "string",
    "totalMillicredits": 1,
    "monthlyRecurringMillicredits": 1,
    "lines": [
      {
        "action": "string",
        "units": 1,
        "millicredits": 1,
        "description": "string"
      }
    ],
    "availableMillicredits": 1,
    "sufficient": true,
    "freeBuild": true,
    "inboxDomainEligibleMillicredits": 1
  }
}
More in Workspace and credits:MeCLI loginsWorkspacesMembersAccess requestsPermission templatesBrandsSharesClient approvalsCreditsCredit ledgerCredit rate cardCredit spendCredit savingsCredit savings rowsBug reportsAll resources