> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-docs-terraform-v2-owner-resources.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Usage Summary

> GetUsageSummary returns tenant-wide LLM gateway token usage: totals, a
 per-model breakdown and a time-bucketed series. Unlike the app-scoped
 RPCs above, this has no app_id -- it is scoped to the caller's tenant
 alone (c1_tenant_id), with no per-Edge/per-app filter.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples get /api/v1/tb-control-plane/usage-summary
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/tb-control-plane/usage-summary:
    get:
      tags:
        - Time Bandit Control Plane
      summary: Get Usage Summary
      description: |-
        GetUsageSummary returns tenant-wide LLM gateway token usage: totals, a
         per-model breakdown and a time-bucketed series. Unlike the app-scoped
         RPCs above, this has no app_id -- it is scoped to the caller's tenant
         alone (c1_tenant_id), with no per-Edge/per-app filter.
      operationId: c1.api.tbcontrolplane.v1.TBControlPlaneService.GetUsageSummary
      parameters:
        - in: query
          name: bucket
          schema:
            description: Defaults to TB_TIME_BUCKET_HOUR when unset.
            enum:
              - TB_TIME_BUCKET_UNSPECIFIED
              - TB_TIME_BUCKET_HOUR
              - TB_TIME_BUCKET_DAY
            type: string
            x-speakeasy-unknown-values: allow
        - in: query
          name: since
          schema:
            description: The since field.
            format: int64
            type: string
        - in: query
          name: until
          schema:
            description: The until field.
            format: int64
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.tbcontrolplane.v1.TBControlPlaneServiceGetUsageSummaryResponse
          description: Successful response
components:
  schemas:
    c1.api.tbcontrolplane.v1.TBControlPlaneServiceGetUsageSummaryResponse:
      description: The TBControlPlaneServiceGetUsageSummaryResponse message.
      properties:
        modelBreakdown:
          description: The modelBreakdown field.
          items:
            $ref: >-
              #/components/schemas/c1.api.tbcontrolplane.v1.TBUsageModelBreakdown
          type:
            - array
            - 'null'
        series:
          description: The series field.
          items:
            $ref: '#/components/schemas/c1.api.tbcontrolplane.v1.TBUsageSummaryBucket'
          type:
            - array
            - 'null'
        totalCacheReadTokens:
          description: The totalCacheReadTokens field.
          format: uint64
          type: string
        totalCacheWriteTokens:
          description: The totalCacheWriteTokens field.
          format: uint64
          type: string
        totalInputTokens:
          description: The totalInputTokens field.
          format: uint64
          type: string
        totalOutputTokens:
          description: The totalOutputTokens field.
          format: uint64
          type: string
        totalRequests:
          description: The totalRequests field.
          format: uint64
          type: string
      title: Tb Control Plane Service Get Usage Summary Response
      type: object
      x-speakeasy-name-override: TBControlPlaneServiceGetUsageSummaryResponse
    c1.api.tbcontrolplane.v1.TBUsageModelBreakdown:
      description: TBUsageModelBreakdown is one (logical_model, model_target) group.
      properties:
        inputTokens:
          description: The inputTokens field.
          format: uint64
          type: string
        logicalModel:
          description: The logicalModel field.
          type: string
        modelTarget:
          description: The modelTarget field.
          type: string
        outputTokens:
          description: The outputTokens field.
          format: uint64
          type: string
        requestCount:
          description: The requestCount field.
          format: uint64
          type: string
      title: Tb Usage Model Breakdown
      type: object
      x-speakeasy-name-override: TBUsageModelBreakdown
    c1.api.tbcontrolplane.v1.TBUsageSummaryBucket:
      description: TBUsageSummaryBucket is one point in GetUsageSummary's time series.
      properties:
        bucketStart:
          format: date-time
          type:
            - string
            - 'null'
        inputTokens:
          description: The inputTokens field.
          format: uint64
          type: string
        outputTokens:
          description: The outputTokens field.
          format: uint64
          type: string
      title: Tb Usage Summary Bucket
      type: object
      x-speakeasy-name-override: TBUsageSummaryBucket
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````