Skip to main content

​
Cost tracking

​
List cost entries

​
/v1/ai/costs
List individual cost entries. Supports pagination.
ParameterTypeDescription
limitintMax results (default: 20)
offsetintPagination offset

​
Aggregate costs

​
/v1/ai/costs/aggregate
Get aggregated cost data over a time range, grouped by provider or model.
ParameterTypeDescription
fromstringStart date (ISO 8601)
tostringEnd date (ISO 8601)
bystringGroup by: provider, model, day
curl "https://api.kombify.io/v1/ai/costs/aggregate?from=2026-03-01&to=2026-03-31&by=provider" \
  -H "Authorization: Bearer $TOKEN"
Response: 
{
  "period": {"from": "2026-03-01", "to": "2026-03-31"},
  "total_tokens": 1250000,
  "estimated_cost_usd": 3.45,
  "by_provider": {
    "openai": {"tokens": 800000, "cost": 1.20},
    "anthropic": {"tokens": 450000, "cost": 2.25}
  }
}

​
Token budget

Token budgets enforce usage limits per tier. Free tier users have a monthly token allowance.

​
Get balance

​
/v1/ai/tokens/balance
Get the user’s current token credit balance and limits.
curl https://api.kombify.io/v1/ai/tokens/balance \
  -H "Authorization: Bearer $TOKEN"

​
Transaction ledger

​
/v1/ai/tokens/ledger
Get recent token transactions (credits used, top-ups, bonuses).
ParameterTypeDescription
limitintMax results (default: 50)

​
Webhooks

Configure webhooks to receive notifications about AI events.

​
Get webhook config

​
/v1/ai/webhooks/config
Get current webhook configuration.

​
Update webhook config

​
/v1/ai/webhooks/config
Set or update webhook endpoint URL and event filters.

​
Delivery logs

​
/v1/ai/webhooks/deliveries/{agent_id}
Get webhook delivery logs for a specific agent.

​
Home Assistant integration

For users with Home Assistant connected to their kombify instance.

​
Converse

​
/v1/ai/ha/converse
Send a conversation request to the HA integration. Requires Brain.

​
Push context

​
/v1/ai/ha/context
Push Home Assistant state context for the AI companion to use.

​
Status

​
/v1/ai/ha/status
Get Home Assistant integration status and connection health.