---
title: "Current organization usage and limits for the active billing period"
method: GET
path: "/organizations/current/usage"
tags: ["Organizations"]
---

# Current organization usage and limits for the active billing period

`GET /organizations/current/usage`

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.

## Response `200`

Successful Response

- OrganizationUsageResponse — 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.
  - `period_start` string, date-time, required
  - `period_end` string, date-time, required
  - `simulation` SimulationUsage, required — Current simulation usage and its configured limit, in hours.
    - `usage` number
    - `limit` number, nullable
  - `compute` ComputeUsage, required — 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).
    - `usage` number
    - `usage_by_type` object
    - `limit` number, nullable

---

[API](https://skmtc.dev/ionworks/apis/fastapi.md) · [All operations](https://skmtc.dev/ionworks/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ionworks/fastapi/revisions/7337a3cbdaf2/schema)