> ## 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.

# 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.




## OpenAPI

````yaml https://raw.githubusercontent.com/honeyhiveai/honeyhive-openapi/main/control_plane_openapi.yaml get /v1/orgs/{org_id}/usage/current
openapi: 3.1.0
info:
  title: HoneyHive Control Plane API
  description: >
    Manage HoneyHive control-plane resources: workspaces, projects and alerts,
    and read org usage.


    Authentication requires a fine-grained control-plane API key (values

    start with `hh_fgcp_`), sent as `Authorization: Bearer <api-key>`.

    Project API keys used with the Data Plane API will not work here. Create

    a key in the HoneyHive app under an organization's or workspace's

    **Settings → API Keys**, or see

    [Authorization](https://docs.honeyhive.ai/v2/control-plane-sdk-reference/typescript#authorization)

    for details.
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  version: 1.17.0
servers:
  - url: https://api.cp.us.honeyhive.ai
security: []
tags:
  - name: Alerts
    description: >
      Define and manage alerts. Alerts evaluate event metrics on a schedule and
      trigger notifications when configured thresholds are crossed.
  - name: Projects
    description: >
      Create and manage projects within a workspace. A project is the container
      for the events, datasets, evaluations, and alerts logged against it.
  - name: Usage
    description: >
      Read an organization's usage: events and computed metrics per calendar
      month, and current user, workspace and project counts.
  - name: Virtual Dataplanes
    description: >
      Create and manage virtual data planes. A virtual data plane is a logical
      tenant boundary inside an organization, hosted on a physical cluster;
      several virtual data planes commonly share one cluster. Workspaces live
      inside a virtual data plane.
  - name: Workspaces
    description: >
      Read and manage workspaces. A workspace groups the projects belonging to
      one team or environment, and owns the API keys and AI provider secrets its
      projects share.
paths:
  /v1/orgs/{org_id}/usage/current:
    get:
      tags:
        - Usage
      summary: Get current usage counts
      description: >
        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.
      operationId: getUsageCurrent
      parameters:
        - in: path
          name: org_id
          required: true
          schema:
            type: string
          description: The unique identifier of the organization
      responses:
        '200':
          description: Counts read successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetUsageCurrentResponse'
        '404':
          description: >-
            Organization not found, or the caller may not read its usage. The
            response does not say which.
      security:
        - ControlPlaneApiKey: []
components:
  schemas:
    GetUsageCurrentResponse:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - true
        data:
          $ref: '#/components/schemas/UsageCurrent'
      required:
        - success
        - data
      additionalProperties: false
      description: Point-in-time org counts
    UsageCurrent:
      type: object
      properties:
        as_of:
          type: string
          description: ISO-8601 timestamp the counts were read at
        user_count:
          type: integer
          minimum: 0
          description: Members who completed onboarding
        workspace_count:
          type: integer
          minimum: 0
          description: Non-archived workspaces
        project_count:
          type: integer
          minimum: 0
          description: Non-archived projects
      required:
        - as_of
        - user_count
        - workspace_count
        - project_count
      additionalProperties: false
  securitySchemes:
    ControlPlaneApiKey:
      type: http
      scheme: bearer
      description: >-
        A fine-grained control-plane API key (values begin with `hh_fgcp_`).
        Project API keys used with the Data Plane API will not work here. Create
        one in the HoneyHive app under an organization's or workspace's
        **Settings → API Keys**.

````

## Related topics

- [Get usage for a date range](https://docs.honeyhive.ai/v2/control-plane-api-reference-autogen/usage/get-usage-for-a-date-range.md)
- [Usage](https://docs.honeyhive.ai/v2/workspace/usage.md)
- [Product](https://docs.honeyhive.ai/v2/changelog/product.md)


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