---
title: "Usage projector: when does this customer run out"
description: "One endpoint returns each customer's current-period usage per feature with a linear end-of-period projection, and each credit pool's balance, average burn, projected depletion date and current credit price. For dashboards, agents and top-up prompts."
date: 2026-08-26
canonical: https://tansohq.com/product/usage-projector
---

# Usage projector

When does this customer run out, and what will it cost to keep going.

One call per customer answers both. Per-feature usage so far this period with a straight-line projection to period end, and per-pool credit balance with average daily burn, the date it hits zero, and the price of a credit right now.

## What it returns

- **Per-feature projection.** Units used this period against the plan's limit, with a linear projection to period end. Held back until 5% of the period has elapsed, so a Monday morning does not forecast the month.
- **Per-pool burndown.** Balance, average burn per day, and the projected depletion date for every credit pool the customer draws on.
- **Priced.** The current credit price from the price book rides along, so "you have 9,000 credits, about 12 days" can also say what a top-up costs.

## Where it shows up

- **REST.** `GET /api/v1/client/customers/{ref}/usage` with a tenant key, or with the customer's own scoped key so a client can render its own burndown without a proxy.
- **MCP.** `getUsageForecast` is one of the curated customer tools, so an agent can check "when do I run out" before it commits to a job.
- **Agent-serve.** Published next to machine-readable pricing and programmatic signup, it is how an agent decides whether to buy more before it starts.

## Also in Tanso

- [Monetization](https://tansohq.com/product/monetization.md)
- [Credit Estimator](https://tansohq.com/credit-estimator.md)

Code: https://github.com/tansohq/tanso-oss · Docs: https://tanso.mintlify.app/agent-serve