About Tanso

Tanso Observe

Tanso Observe offers low-lift AI cost observability and margin analytics. Track what every
customer and feature costs you to deliver, see which are profitable, and get
alerts when margins slip. Sign up and access documentation at observe.tansohq.com.

Tanso Platform

When you're ready to enforce limits and bill customers, upgrade to Platform. Your event pipeline carries over with zero code changes. Sign up for the platform at dashboard.tansohq.com.

Platform adds two API calls to the pattern:

// Before processing: can this customer use this feature?
const check = await fetch('https://api.tansohq.com/api/v1/client/entitlements/check', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    customerReferenceId: 'cus_123',
    featureKey: 'ai_summarization',
  })
})
const { allowed } = await check.json()
if (!allowed) return res.status(403).json({ error: 'Usage limit reached' })

// Process the request, then report usage (same event call as Observe)

Platform gives you:

Plans and pricing rules -- bundle features, set prices, manage tiers
Entitlement enforcement -- real-time access checks before serving requests
Usage caps and credits -- hard limits, credit pools, rollover policies
Stripe integration -- usage rolls up into invoices automatically

Core Concepts

Concept	What It Is
Event	A usage record with cost and revenue attached. The foundation for everything.
Customer	A billing entity keyed by your own ID. No sync required.
Feature	Something you track or gate: `ai_summarization`, `api_calls`, `seats`
Plan	A bundle of features with pricing (Platform)
Subscription	Links a customer to a plan (Platform)
Entitlement	Real-time answer to "can this customer use this feature?" (Platform)
Credit	Pre-paid balance with rollover policies and hard limits (Platform)
Invoice	A billing document generated from subscriptions (Platform)

For detailed explanations of each concept and how they relate, see Core Concepts.

LLM-Friendly Docs

Feed your AI coding assistant:

https://docs.tansohq.com/llms.txt -- concise summary
https://docs.tansohq.com/llms-full.txt -- complete reference
npm install @tansohq/sdk -- typed autocomplete