Skip to content
View as Markdown

tinker.types.BillingUsageResponse

Generated from tinker 0.30.4 at commit 1e5777e. Source links point at that snapshot.

class tinker.types.BillingUsageResponse(BaseModel)

Fields:

  • data (list[BillingUsageEvent]) – Hourly usage events, ordered by bucket then descending token count
  • sessions (dict[str, BillingUsageSession]) – session_id -> that session's attributes, for every distinct session appearing in data

  • cost_data_through (datetime | None) – Conservative exclusive UTC completeness watermark for invoice-reconciled costs. The server checks each full UTC day touched by the request, even for a partial-day window, and advances this boundary only across consecutive completed billable-usage days. It stops before the first day whose usage and invoice exports do not reconcile.

    This is not the latest timestamp carrying any estimated cost: current-day rate-card estimates do not advance it, and a reconciled day after an earlier gap may contain costs beyond it. None means no initial completed billable-usage day advanced the watermark. When all touched completed days through yesterday reconcile, it is the most recent UTC midnight.

Referenced by