Skip to Content
Workspace and account

Credit rate card

What each action costs in credits.

Workspace and account1 endpointKen-Version: 2026-11-02AuthenticationWorkspacesErrors
MarkdownOpenAPI

Headers

The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.

NameInTypeRequiredDescription
Ken-Versionheaderstring, one of: 2026-11-02, 1.1optionalThe 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 date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy.
X-Ken-Workspace-Idheaderinteger (int64)optionalThe id of a workspace to answer for. Without it the call answers for no workspace. A workspace you are not a member of answers 404 not_found.

Get the credit rate card

GET/v1/credits/rate-cardcredit-rate-card.get
Permission
Any signed-in caller
Rate limit
12,000 requests a minute per API key

Try it on developer.ken.so

Returns the price of every credit action, such as a found email, AI qualification of 1,000 contact rows or a Kenso inbox for a month. The call needs no X-Ken-Workspace-Id; send it to get the card of that workspace (see version).

millicreditsPerUnit is the price of one unit, and unitSize is the quantity prices are usually quoted for. pricing says how to read it: fixed is the exact price; typical marks work whose price depends on what it does (a campaign build, a reply draft, a reply, a Ken chat turn, a translation, a podcast request), and millicreditsPerUnit is then the median price of one unit across Kenso in the last 30 days, or 0 while fewer than 20 units were charged. typical says how it was measured. Each ledger line shows the exact amount. A domain row's price depends on the name, so a domain order shows each name's price in credits before checkout.

Some rows appear only while Kenso offers the action: web_scrape, podcast_search, places_search_page, places_detail_open, instagram_account_monthly, event_post_person, event_post_person_paid_source, social_data_record and smtp_email.

depths prices one lead at each campaign depth (bulk, personalized, multichannel) from these rows. A campaign estimate with that depth uses the same price per lead.

version is 1 unless you send X-Ken-Workspace-Id for a workspace on the new plans, which gets that card with version 2: its rows use the new prices, and a row may have millicreditsPerUnit 0 (not charged in credits).

Open to any signed-in caller.

Request
curl -X GET "https://api.ken.so/v1/credits/rate-card" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"

Response 200

data is a CreditRateCard.

Show the 5 response fields and an example

The fields and an example are also on this endpoint's Markdown page.


On this page