Entitlements & Metering

Turn pricing plans into infrastructure rules.

Define what each customer can access and how much they can consume. Kaiten enforces the limits at the SDK level and streams real-time usage data to your billing and sales tools.

Get Started Read the Docs

Your billing says one thing. Your infrastructure does another.

The mapping between 'what the customer pays for' and 'what they can actually do' is maintained by a spreadsheet, a Confluence page, or if statements buried in application code.

Revenue leakage

Expired trials still access premium features

Quota violations

No one knows limits are exceeded until the monthly invoice

Engineering overhead

Every new plan requires code changes and a deployment

Sales friction

'Let me check with Engineering' — a conversation that takes 3 days

Entitlements as code. Metering as a service.

Entitlement Types

Three primitives. Infinite packaging.

Boolean entitlements gate feature access. Numeric entitlements enforce quotas and limits. Config entitlements carry structured JSON payloads. Define once, enforce everywhere.

Real-Time Metering

Track consumption without building a data pipeline.

Your instances report usage events to Kaiten. We aggregate them in real time using configurable methods — SUM, COUNT, MAX, MIN, AVERAGE, LATEST. No Kafka, no custom ETL.

Threshold Alerts & Webhooks

Know the second a customer hits their limit.

When usage crosses a threshold, Kaiten fires a webhook event. Trigger Slack alerts, upsell emails, instance suspension, or overage charges — automatically.

Compliance-Grade Audit Trail

Every SDK call. Every limit check. Traced.

Kaiten maintains an append-only event log for every entitlement evaluation and usage report. Query the audit trail for compliance, debugging, or analytics.

License-Based Packaging

One license change. Instant enforcement.

Entitlements are assigned to license tiers. When you change a customer's license — upgrade, downgrade, or trial expiration — all values update instantly across every instance.

Real-time metering in action.

curl

# Report a usage event
curl -X POST https://api.kaiten.sh/api/instances/acme-prod/usage \
  -H "Authorization: Bearer ksh_your_token" \
  -d '{
    "entitlement_slug": "api-calls",
    "value": 1
  }'

# Check current state
GET /api/instances/acme-prod/entitlements/api-calls/usage
→ {
    "entitlement": "api-calls",
    "limit": 100000,
    "current_usage": 67433,
    "percentage_used": 67.4,
    "status": "ACCEPTED"
  }

Why not Stigg or Schematic?

Stigg and Schematic are good entitlement platforms. But they don't control your feature flags, and they can't orchestrate your deployments.

Capability	Kaiten	Stigg	Schematic	Custom (internal)
Boolean entitlements	✅	✅	✅	✅ (manual)
Numeric quotas + metering	✅ Native	✅	✅	❌ Build yourself
Config entitlements	✅ Typed JSON	❌	❌	❌
Feature flags (integrated)	✅ OpenFeature	❌	Partial	❌
Deployment orchestration	✅	❌	❌	❌
Audit trail	✅ Compliance-grade	Partial	Partial	❌
Open source	✅	❌	❌	✅ (unmaintained)
Self-hostable	✅	❌	❌	✅
Webhook events (27 types)	✅	Partial	Partial	❌