---
title: "Describe organization usage"
method: GET
path: "/usage"
---

# Describe organization usage

`GET /usage`

Describe usage statistics for the user's organization for the current billing cycle.

## Response `200`

OK

- OrganizationUsage
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `active_schedules` UsageLimit, required
    - `limit` integer, required — For numeric quotas: the maximum number of units allowed (-1 means unlimited). For boolean entitlements (e.g. self_hosted_runners): 0 = disabled, 1 = enabled.
    - `used` integer, required — The number of units used for this resource.
  - `apps` UsageLimit, required
    - `limit` integer, required — For numeric quotas: the maximum number of units allowed (-1 means unlimited). For boolean entitlements (e.g. self_hosted_runners): 0 = disabled, 1 = enabled.
    - `used` integer, required — The number of units used for this resource.
  - `base_plan_name` string, required — The name of the organization's base plan.
  - `compute_minutes` UsageLimit, required
    - `limit` integer, required — For numeric quotas: the maximum number of units allowed (-1 means unlimited). For boolean entitlements (e.g. self_hosted_runners): 0 = disabled, 1 = enabled.
    - `used` integer, required — The number of units used for this resource.
  - `members` UsageLimit, required
    - `limit` integer, required — For numeric quotas: the maximum number of units allowed (-1 means unlimited). For boolean entitlements (e.g. self_hosted_runners): 0 = disabled, 1 = enabled.
    - `used` integer, required — The number of units used for this resource.
  - `organization_name` string, required — The name of the organization.
  - `self_hosted_runners` UsageLimit, required
    - `limit` integer, required — For numeric quotas: the maximum number of units allowed (-1 means unlimited). For boolean entitlements (e.g. self_hosted_runners): 0 = disabled, 1 = enabled.
    - `used` integer, required — The number of units used for this resource.
  - `storage` OrganizationStorageUsage, required
    - `measured_at` string, date-time, nullable, required — When the total was measured. Null when no measurement is available.
    - `total_bytes` integer, required — Physical bytes across the organization's Tower-managed catalogs, including Iceberg metadata and not-yet-compacted snapshot history.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/tower/apis/tower-api.md) · [All operations](https://skmtc.net/tower/apis/tower-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tower/tower-api/revisions/0e42b0fb26d9/schema)