---
title: "View organization usage"
method: GET
path: "/v0/organizations/{organization}/usage"
tags: ["organizations", "usage"]
---

# View organization usage

`GET /v0/organizations/{organization}/usage`

View the metrics and bare metal runner minutes usage of an organization. The user must have `manage` permissions for the organization. ➕ Bencher Plus: This endpoint offers an estimate of metered usage and exact usage for licensed organizations, both on Bencher Cloud and Bencher Self-Hosted.

## Path parameters

- `organization` string, required

## Response `200`

successful operation

- JsonUsage
  - `active_series` integer, nullable — The active series usage amount. Populated for Pro metered plans, whose bill is based on monthly-active series (distinct testbed x benchmark x measure).
  - `end_time` string, date-time, required
  - `kind` union, required
    - 'cloud_free' — Bencher Cloud (Free)
    - 'cloud_metered' — Bencher Cloud (Metered)
    - 'cloud_self_hosted_licensed' — Bencher Self-Hosted (Licensed) via Bencher Cloud
    - 'self_hosted_free' — Bencher Self-Hosted (Free)
    - 'self_hosted_licensed' — Bencher Self-Hosted (Licensed)
  - `license` JsonLicense
    - `entitlements` integer, required
    - `expiration` string, date-time, required
    - `issued_at` string, date-time, required
    - `key` string, required
    - `level` 'free' | 'pro' | 'team' | 'enterprise', required
    - `organization` string, uuid, required
  - `metrics` integer, nullable — The metrics usage amount. Not populated for Pro metered plans, which bill on active series (see `active_series`) rather than metrics.
  - `organization` string, uuid, required
  - `plan` JsonPlan
    - `cancel_at_period_end` boolean, required — Whether the subscription is set to cancel at the end of the current period (the org keeps access until `current_period_end`, then downgrades to Free).
    - `card` JsonCardDetails, required
      - `brand` 'amex' | 'diners' | 'discover' | 'jcb' | 'mastercard' | 'unionpay' | 'visa' | 'unknown', required
      - `exp_month` integer, required
      - `exp_year` integer, required
      - `last_four` string, required
    - `created` string, date-time, required
    - `current_period_end` string, date-time, required
    - `current_period_start` string, date-time, required
    - `customer` JsonCustomer, required
      - `email` string, required
      - `name` string, required
      - `uuid` string, uuid, required
    - `level` 'free' | 'pro' | 'team' | 'enterprise', required
    - `license` JsonLicense
      - `entitlements` integer, required
      - `expiration` string, date-time, required
      - `issued_at` string, date-time, required
      - `key` string, required
      - `level` 'free' | 'pro' | 'team' | 'enterprise', required
      - `organization` string, uuid, required
    - `organization` string, uuid, required
    - `status` 'active' | 'canceled' | 'incomplete' | 'incomplete_expired' | 'past_due' | 'paused' | 'trialing' | 'unpaid', required
    - `tiers` JsonPriceTier[], nullable — The tiered price ladder for this plan, ordered ascending by `up_to`. Populated for the Pro tiered active-series price; `None` for flat-priced or licensed plans.
      - `flat_amount` integer
      - `unit_amount` integer
      - `up_to` integer, nullable — Inclusive upper bound (active-series count) for this tier. `None` is the unbounded top tier, presented as "Get in Touch".
    - `unit_amount` integer, required
  - `runner_minutes` integer, nullable — The runner minutes usage amount.
  - `start_time` string, date-time, required

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/bencherdev/apis/bencher-api.md) · [All operations](https://skmtc.net/bencherdev/apis/bencher-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bencherdev/bencher-api/versions/84086e99e6cd/schema)