# tinker.types.BillingUsageResponse

*Generated from tinker 0.30.4 at commit [`1e5777e`](https://github.com/thinking-machines-lab/tinker/tree/1e5777ef1e0bb2bae6d9b8d63a6144eec405377d). Source links point at that snapshot.*

## *class* [**tinker.types.BillingUsageResponse**](https://github.com/thinking-machines-lab/tinker/blob/1e5777ef1e0bb2bae6d9b8d63a6144eec405377d/src/tinker/types/billing_usage_response.py#L155)(*[BaseModel](https://github.com/thinking-machines-lab/tinker/blob/1e5777ef1e0bb2bae6d9b8d63a6144eec405377d/src/tinker/_models.py#L88)*)

**Fields:**

- [**data**](https://github.com/thinking-machines-lab/tinker/blob/1e5777ef1e0bb2bae6d9b8d63a6144eec405377d/src/tinker/types/billing_usage_response.py#L156) (*[list](https://github.com/thinking-machines-lab/tinker/blob/1e5777ef1e0bb2bae6d9b8d63a6144eec405377d/src/tinker/cli/commands/run.py#L221)\[[BillingUsageEvent](https://tinker-docs.thinkingmachines.ai/tinker/api-reference/types/billingusageevent/index.md)\]*) – Hourly usage events, ordered by bucket then descending token count

- [**sessions**](https://github.com/thinking-machines-lab/tinker/blob/1e5777ef1e0bb2bae6d9b8d63a6144eec405377d/src/tinker/types/billing_usage_response.py#L159) (*dict\[str, [BillingUsageSession](https://tinker-docs.thinkingmachines.ai/tinker/api-reference/types/billingusagesession/index.md)\]*) – session_id -> that session's attributes, for every distinct session appearing in `data`

- [**cost_data_through**](https://github.com/thinking-machines-lab/tinker/blob/1e5777ef1e0bb2bae6d9b8d63a6144eec405377d/src/tinker/types/billing_usage_response.py#L163) (*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

- [RestClient.get_billing_usage](https://tinker-docs.thinkingmachines.ai/tinker/api-reference/restclient/#get_billing_usage)