TESSEN Platform
Documentation
Docs/API reference
API REFERENCE

Usage

Read your monthly request and token totals. For what you were charged, read the wallet ledger.

GET/v1/economy/usage

Your usage totals for a month.

Auth: Bearer key

Query

periodstring

A 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"

Response

periodstring

The month, YYYY-MM.

requests, successful_requests, failed_requestsinteger

Request counts.

input_tokens, output_tokens, cached_tokens, reasoning_tokensinteger

Token totals.

tool_executions, workflow_executions, agent_executionsinteger

Counts for Tessen's own products.

estimated_cost_usd, billable_amount_usdnumber

Metering 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.

Search documentation

Titles, headings and guides↑ ↓ navigate · Enter open
Usage · Tessen Docs