---
title: "Usage Quota"
method: GET
path: "/usage/quota"
tags: ["usage"]
---

# Usage Quota

`GET /usage/quota`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/usage/quota`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Query parameters

- `workspace_id` string, uuid, nullable

## Response `200`

Successful Response

- Quota
  - `at` string, date-time, required
  - `tier` string, nullable, required
  - `llm_tier` Plan, required: Your organisation's current LLM plan, expired or not, as GET /usage/quota shows it (``llm_tier``): whether it includes LLM training on OS3 GPUs (``gpu``) and its limits (``training_bases``: the training it includes; RLVR, base halo_rlvr, on every plan), its monthly fee (``platform_fee_usd``: yours when OS3 set one), the H100-seconds it includes once (``grant_h100_seconds``, the Free trial's) and how it serves your models (``serving``: per_token on shared GPUs at its ``rates`` now, reserved_capacity on dedicated GPUs).
    - `name` string, required
    - `expires_at` string, date-time, nullable, required
    - `gpu` boolean, required
    - `limits` Limits, required
      - `valid_days` integer, nullable
      - `eval_sets` integer, nullable
      - `optimisation_traces` integer, nullable
      - `training_bases` string[], nullable
      - `training_max_params_b` integer, nullable
      - `gateway_rpm` integer, nullable
      - `gateway_tpm` integer, nullable
    - `platform_fee_usd` string, nullable, required
    - `grant_h100_seconds` integer, nullable, required
    - `serving` PlanServing, required: How the plan serves your models: per_token on shared GPUs at ``rates`` per 1M tokens (in effect now; ``profiles``: a base model's own), reserved_capacity on dedicated GPUs, none.
      - `basis` 'none' | 'per_token' | 'reserved_capacity', required
      - `rates` ServingRates, required: The rates from ``since`` (a UTC day) until they change, and a base model's own rates (``profiles``); any other model's are these.
        - `input_per_1m` string, nullable, required
        - `cached_input_per_1m` string, nullable, required
        - `output_per_1m` string, nullable, required
        - `provisional` boolean
        - `since` string, date, nullable
        - `profiles` object
  - `compute` ComputeBar, required
    - `granted` string, required
    - `used` string, required
    - `balance` string, required
    - `overage` string, required
    - `per_day` string, required
    - `exhausts_at` string, date-time, nullable, required
    - `runs_like_last` integer, nullable, required
    - `jobs` JobUsage[], required
      - `job_id` string, uuid, required
      - `number` integer, required
      - `dataset_version_id` string, uuid, required
      - `base` string, required
      - `gpu` string, required
      - `steps` integer, required
      - `state` string, required
      - `h100_seconds` string, required
      - `ended_at` string, date-time, required
      - `infra_credits` InfraCredit[], required
        - `id` integer, required
        - `h100_seconds` string, required
        - `explanation` string, nullable, required
    - `datasets` DatasetCompute[], required
      - `dataset_version_id` string, uuid, required
      - `dataset` string, nullable, required
      - `name` string, nullable, required
      - `version` integer, nullable, required
      - `h100_seconds` string, required
  - `storage` StorageBar, required
    - `granted` string, required
    - `used` string, nullable, required
    - `per_day` string, nullable, required
    - `exhausts_at` string, date-time, nullable, required
    - `datasets` DatasetStorage[], required
      - `dataset_version_id` string, uuid, required
      - `dataset` string, required
      - `version` integer, required
      - `gb` string, required

## Other responses

- `422`: Validation Error

---

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