Kenso

Credit spend

What the workspace spent per category in a period.

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

Net millicredits per spend category (infrastructure, ai, data, sending, calling, always all five), each with its USD amount in cents at $0.02 a credit, plus the total and the number of grant, expiry and adjustment lines (addedExpiredLineCount). A refund or overrun write-off counts against its charge's category; not-charged (shadow) lines count as lines but add no spend. period is billing_month (default: the current billing month, or since signup on the Free plan, reported as since_signup), last_30_days or all_time. Scoped like the ledger: a master or standalone workspace includes its white-label children, a child sees its own lines. Read only. Needs the billing feature.

Parameters

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

Field
Type
Description
object
string
Always credit_spend.
period
string
billing_month, since_signup (what billing_month resolves to on Free), last_30_days or all_time.
from
string (date-time)
Inclusive start. Omitted for all_time.
to
string (date-time)
Exclusive end: the billing month's end, else now.
totalMillicredits
integer (int64)
The spend categories' millicredits added up.
totalAmount
MoneyModel
categories
array of CreditSpendCategoryModel
infrastructure, ai, data, sending and calling, always all five in that order.
addedExpiredLineCount
integer (int32)
Grant, expiry and manual adjustment lines in the period (the "Added and expired" chip).
Request
curl -X GET "https://api.ken.so/v1/credits/spend" \
  -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": {
    "object": "string",
    "period": "string",
    "from": "2026-09-23T15:02:11Z",
    "to": "2026-09-23T15:02:11Z",
    "totalMillicredits": 1,
    "totalAmount": {
      "amount": 1,
      "currency": "string"
    },
    "categories": [
      {
        "category": "string",
        "millicredits": 1,
        "amount": {
          "amount": 1,
          "currency": "string"
        },
        "lineCount": 1
      }
    ],
    "addedExpiredLineCount": 1
  }
}