Get Billing Projection V1
Linear projection of end-of-period spend given current burn rate…
GET
Linear projection of end-of-period spend given current burn rate.
Lets tenants spot a runaway month early — ‘we’re 3 days in and the
projection says we’ll hit $850 by month-end, time to investigate.’
Naive: just extrapolates the average daily cost. Doesn’t model
weekends, demand spikes, or seasonal patterns.
Response
BillingProjectionResponse
string,null
ISO 8601 of the billing period’s start. None when no subscription is on file.
string,null
ISO 8601 of the billing period’s end.
number
required
Decimal days from period_start to now, capped at the period length.
number
required
number
required
number
required
period_cost_so_far / max(days_elapsed, 1). USD/day.
number
required
Linear extrapolation: cost_so_far + (daily_burn_rate × days_remaining). Naive — does not model end-of-month spikes or weekend tapering.
string
required
actual when we have a real period and at least some elapsed time; no_subscription when no subscription row exists; no_window when a subscription exists but has no billing_period_start/end (yet to be set by Stripe sync).