---
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`

## Request

- Base URL: `https://api.ionworks.com`
- URL: `https://api.ionworks.com/organizations/current/usage`
- Auth: none declared

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

## Changes

- **2026-10-26** `729b8cca71b0`: 1 warning
  - added the new `surrogate_training` enum value to the `compute/usage_by_type/propertyNames/` response property for the response status `200`

[Operation history](https://skmtc.dev/ionworks/apis/ionworks-api/changes/organizations/current/usage/get.md)

---

[API](https://skmtc.dev/ionworks/apis/ionworks-api.md) - [All operations](https://skmtc.dev/ionworks/apis/ionworks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ionworks/apis/ionworks-api/revisions/abebbbc5f60a?raw)