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

# Current organization usage and limits for the active billing period

> Return the org-wide usage for the current calendar month and configured limits.

Usage is aggregated across all members of the organization (limits are
org-level) for the current calendar-month period and resets on the first of
each month. Simulation usage is a single figure; compute usage is broken
down by job type with the total in ``compute.usage``. All values are in
hours; a ``None`` limit means that usage type is unconstrained.



## OpenAPI

````yaml https://api.ionworks.com/openapi.json get /organizations/current/usage
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://api.ionworks.com
    description: Production
security: []
paths:
  /organizations/current/usage:
    get:
      tags:
        - Organizations
      summary: Current organization usage and limits for the active billing period
      description: >-
        Return the org-wide usage for the current calendar month and configured
        limits.


        Usage is aggregated across all members of the organization (limits are

        org-level) for the current calendar-month period and resets on the first
        of

        each month. Simulation usage is a single figure; compute usage is broken

        down by job type with the total in ``compute.usage``. All values are in

        hours; a ``None`` limit means that usage type is unconstrained.
      operationId: get_current_organization_usage_organizations_current_usage_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationUsageResponse'
components:
  schemas:
    OrganizationUsageResponse:
      properties:
        period_start:
          type: string
          format: date-time
          title: Period Start
        period_end:
          type: string
          format: date-time
          title: Period End
        simulation:
          $ref: '#/components/schemas/SimulationUsage'
        compute:
          $ref: '#/components/schemas/ComputeUsage'
      type: object
      required:
        - period_start
        - period_end
        - simulation
        - compute
      title: OrganizationUsageResponse
      description: |-
        Org usage and limits for the current calendar-month billing period.

        Usage resets on the first of each month. All usage/limit values are in
        hours.
    SimulationUsage:
      properties:
        usage:
          type: number
          title: Usage
          default: 0
        limit:
          anyOf:
            - type: number
            - type: 'null'
          title: Limit
      type: object
      title: SimulationUsage
      description: Current simulation usage and its configured limit, in hours.
    ComputeUsage:
      properties:
        usage:
          type: number
          title: Usage
          default: 0
        usage_by_type:
          additionalProperties:
            type: number
          propertyNames:
            $ref: '#/components/schemas/ComputeJobType'
          type: object
          title: Usage By Type
          default: {}
        limit:
          anyOf:
            - type: number
            - type: 'null'
          title: Limit
      type: object
      title: ComputeUsage
      description: |-
        Current compute usage and its configured limit, in hours.

        ``usage`` is the total across all job types; ``usage_by_type`` breaks it
        down (informational — the ``limit`` applies to the total).

````