> ## Documentation Index
> Fetch the complete documentation index at: https://docs.honeyhive.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage Methods

> HoneyHive TypeScript Control Plane SDK Usage namespace reference

#### get

> **get**(`request`: [`GetUsageRequest`](https://docs.honeyhive.ai/v2/control-plane-sdk-reference/typescript/ref/usage/GetUsageRequest)): `Promise`\<[`GetUsageResponse`](https://docs.honeyhive.ai/v2/control-plane-sdk-reference/typescript/ref/usage/GetUsageResponse)>

**Accepted keys:** [Control plane fine-grained API key](https://docs.honeyhive.ai/v2/workspace/api-keys.md#key-types)

Get usage for a date range

Return an organization's usage for `[start_date, end_date)`, in one bucket per calendar
month, clipped to the range and ending at the current month. The organization is identified
by the `org_id` path parameter alone; the `x-hh-org-id` header does not participate.

An event counts in the month that contains its `start_time`, which the client sets when it
logs the event, so usage for a past month can still grow. `metrics_computed_count` is the
number of `metrics.*` keys on those events. Results are always split by `event_type`; pass
`group_by` to also split them by workspace or by project. Every row is returned in one
response; there is no pagination. Quarter- and year-to-date totals are for the caller to
sum across ranges.

#### getCurrent

> **getCurrent**(`request`: [`GetUsageCurrentRequest`](https://docs.honeyhive.ai/v2/control-plane-sdk-reference/typescript/ref/usage/GetUsageCurrentRequest)): `Promise`\<[`GetUsageCurrentResponse`](https://docs.honeyhive.ai/v2/control-plane-sdk-reference/typescript/ref/usage/GetUsageCurrentResponse)>

**Accepted keys:** [Control plane fine-grained API key](https://docs.honeyhive.ai/v2/workspace/api-keys.md#key-types)

Get current usage counts

Return an organization's current counts, independent of any date range: members who
completed onboarding, and non-archived workspaces and projects. The organization is
identified by the `org_id` path parameter alone; the `x-hh-org-id` header does not
participate.


## Related topics

- [Usage](https://docs.honeyhive.ai/v2/workspace/usage.md)
- [Namespaces](https://docs.honeyhive.ai/v2/control-plane-sdk-reference/typescript/ref/namespaces.md)
- [Events Methods](https://docs.honeyhive.ai/v2/sdk-reference/typescript/ref/events/index.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.