API REFERENCE
Usage
Read your monthly request and token totals. For what you were charged, read the wallet ledger.
GET
/v1/economy/usageYour usage totals for a month.
Auth: Bearer keyQuery
periodstringA month, YYYY-MM. Defaults to the current month.
READ USAGE
curl "https://api.tessen.ai/v1/economy/usage?period=2026-10" \ -H "Authorization: Bearer $TESSEN_API_KEY"import osimport requests response = requests.get( "https://api.tessen.ai/v1/economy/usage", params={"period": "2026-10"}, headers={"Authorization": f"Bearer {os.environ['TESSEN_API_KEY']}"}, timeout=30,)response.raise_for_status()usage = response.json()print(usage["period"], usage["requests"], "requests,", usage["input_tokens"], "input tokens,", usage["output_tokens"], "output tokens")const response = await fetch("https://api.tessen.ai/v1/economy/usage?period=2026-10", { headers: { Authorization: `Bearer ${process.env.TESSEN_API_KEY}` },});if (!response.ok) throw new Error(`HTTP ${response.status}`);const usage = await response.json();console.log(usage.period, usage.requests, "requests,", usage.input_tokens, "input tokens,", usage.output_tokens, "output tokens");Response
periodstringThe month, YYYY-MM.
requests, successful_requests, failed_requestsintegerRequest counts.
input_tokens, output_tokens, cached_tokens, reasoning_tokensintegerToken totals.
tool_executions, workflow_executions, agent_executionsintegerCounts for Tessen's own products.
estimated_cost_usd, billable_amount_usdnumberMetering estimates. They are not charges and are not a statement of what your wallet paid.
Limit
Usage is reported as monthly totals. Daily series and per-key breakdowns are not available from this endpoint. Project ZERO requests are counted here, and may show a small estimated amount, but they never debit your wallet.
What you were charged
Every charge is a row in the wallet ledger, with the family and endpoint in its reason. Per-request cost is also in the final frame of a streamed response.