Sending capacity
The Sending capacity endpoints of the Kenso API.
Forecast the current workspace's email sends for UTC today and the next two days: what its healthy inboxes can send per day (capacity), what is already queued or planned (planned), and what is left (remaining)
GET
/v1/sending-capacity/forecastsending-capacity.get-forecastPublic, read only, Delivery view. Takes no what-if inputs; the staff forecast keeps those.
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).Response 200
data is a SendingCapacityForecastModel.
Field
Type
Description
calculatedAt
string (date-time)
When Kenso computed the forecast (UTC).
days
array of SendingCapacityForecastDayModel
UTC today, tomorrow and the day after, in that order.
Request
curl -X GET "https://api.ken.so/v1/sending-capacity/forecast" \ -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": {
"calculatedAt": "2026-09-23T15:02:11Z",
"days": [
{
"date": "string",
"capacity": 1,
"sent": 1,
"planned": 1,
"remaining": 1
}
]
}
}