# tinker.types.BillingUsageEvent

## *class* [**tinker.types.BillingUsageEvent**](https://github.com/thinking-machines-lab/tinker/blob/main/src/tinker/types/billing_usage_response.py#L83)(*[BaseModel](https://github.com/thinking-machines-lab/tinker/blob/main/src/tinker/_models.py#L88)*)

One hourly bucket of billing usage: shared attribution dimensions on the envelope, with the usage-kind-specific payload in `event_info` (a tagged union discriminated on `.type`).

**Fields:**

- [**bucket_start**](https://github.com/thinking-machines-lab/tinker/blob/main/src/tinker/types/billing_usage_response.py#L88) (*datetime*) – Inclusive start of the UTC hour bucket
- [**bucket_end**](https://github.com/thinking-machines-lab/tinker/blob/main/src/tinker/types/billing_usage_response.py#L91) (*datetime*) – Exclusive end of the UTC hour bucket
- [**base_model**](https://github.com/thinking-machines-lab/tinker/blob/main/src/tinker/types/billing_usage_response.py#L94) (*str | None*) – Base model the usage was billed against (None when unknown, e.g. storage from before base-model stamping)
- [**user_id**](https://github.com/thinking-machines-lab/tinker/blob/main/src/tinker/types/billing_usage_response.py#L98) (*str | None*) – Organization-user urn of the user that created the session the usage is attributed to
- [**user_name**](https://github.com/thinking-machines-lab/tinker/blob/main/src/tinker/types/billing_usage_response.py#L102) (*str | None*) – Display name of `user_id`, as self-reported during onboarding
- [**session_id**](https://github.com/thinking-machines-lab/tinker/blob/main/src/tinker/types/billing_usage_response.py#L105) (*str | None*) – The session the usage is attributed to: for sampling the session that issued the requests, for training the session that created the training run. None for events without a session (storage, usage from before session tagging). Session user_metadata is available in `BillingUsageResponse.sessions` — keyed by this id.
- [**project_id**](https://github.com/thinking-machines-lab/tinker/blob/main/src/tinker/types/billing_usage_response.py#L112) (*str | None*) – Project this usage belongs to, resolved from the current project associated with the session identified by `session_id`
- [**event_info**](https://github.com/thinking-machines-lab/tinker/blob/main/src/tinker/types/billing_usage_response.py#L116) (*[BillingEventInfo](https://github.com/thinking-machines-lab/tinker/blob/main/src/tinker/types/billing_usage_response.py#L71)*) – What kind of usage this is and its quantity; dispatch on `event_info.type`

## Referenced by

- [RestClient.get_billing_usage](https://tinker-docs.thinkingmachines.ai/tinker/api-reference/restclient/#get_billing_usage)
- [tinker.types.BillingUsageResponse](https://tinker-docs.thinkingmachines.ai/tinker/api-reference/types/billingusageresponse/index.md)