---
title: "Quotas, per-workspace ceilings/reservations/grants and compute budget leases"
method: GET
path: "/v1/organizations/{organization_id}/grants"
tags: ["Usage and spend"]
---

# Quotas, per-workspace ceilings/reservations/grants and compute budget leases

`GET /v1/organizations/{organization_id}/grants`

## Request

- Base URL: `https://api.shardflux.dev`
- URL: `https://api.shardflux.dev/v1/organizations/{organization_id}/grants`
- Auth: HTTP bearer

Ceiling = min(template, user cap, plan cap). Reservations are organization-level (pending starts count). Leases are the compute budgets granted to the cell (<= 15 min). API keys see only their own project’s workspaces.

## Path parameters

- `organization_id` string, uuid, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Default Response

- object
  - `organization_id` string, uuid, required: UUIDv7, lowercase canonical form.
  - `plan` object, nullable, required
    - `plan_key` string, required
    - `catalog_version` string, required
    - `priority` string, nullable, required
    - `overage` string, nullable, required
  - `limits` object, required: Organization quotas and per-workspace caps from the plan (null = unlimited).
  - `reserved` object, required: Organization-level reservations (pending starts count against quotas).
    - `pending` object, required
      - `count` integer, required
      - `cpu_millis` integer, required
      - `memory_mib` integer, required
      - `disk_gib` integer, required
    - `committed` object, required
      - `count` integer, required
      - `cpu_millis` integer, required
      - `memory_mib` integer, required
      - `disk_gib` integer, required
  - `workspaces` object[], required
    - `id` string, uuid, required: UUIDv7, lowercase canonical form.
    - `workspace_key` string, required
    - `project_id` string, uuid, required: UUIDv7, lowercase canonical form.
    - `observed_state` string, required
    - `desired_state` string, required
    - `ceilings` object, nullable, required
      - `cpu_millis` integer, required
      - `memory_mib` integer, required
      - `disk_gib` integer, required
      - `sources` object, required
    - `user_caps` object, required
      - `cpu_millis` integer, nullable, required
      - `memory_mib` integer, nullable, required
      - `disk_gib` integer, nullable, required
    - `reservation` object, nullable, required
      - `state` string, required
      - `cpu_millis` integer, required
      - `memory_mib` integer, required
      - `disk_gib` integer, required
    - `grants` object, nullable, required: Actual grants reported by the cell for the last start.
    - `pending_operation` object, nullable, required
      - `id` string, uuid, required: UUIDv7, lowercase canonical form.
      - `kind` string, required
      - `state` string, required
      - `state_reason` string, nullable, required
  - `next_cursor` string, nullable, required
  - `leases` object[], required
    - `id` string, uuid, required: UUIDv7, lowercase canonical form.
    - `cell_id` string, required
    - `sequence` integer, required
    - `state` string, required
    - `capped` boolean, required
    - `cpu_seconds` number, required
    - `memory_gib_seconds` number, required
    - `transfer_bytes` integer, nullable, required
    - `usage_from` string, date-time, required: RFC 3339 UTC timestamp with Z.
    - `issued_at` string, date-time, required: RFC 3339 UTC timestamp with Z.
    - `expires_at` string, date-time, required: RFC 3339 UTC timestamp with Z.
    - `end_reason` string, nullable, required
    - `burn_rate` object, required
      - `cpu_seconds_per_second` number, required
      - `memory_gib` number, required
      - `workspaces` integer, required
    - `overshoot_bound` object, required
      - `cpu_seconds` number, required
      - `memory_gib_seconds` number, required
    - `cell_consumed_cpu_seconds` number, nullable, required
    - `cell_consumed_memory_gib_seconds` number, nullable, required
    - `cell_acknowledged_at` string, date-time, nullable, required: RFC 3339 UTC timestamp with Z.
  - `lease_policy` object, required
    - `ttl_seconds` integer, required
    - `renew_before_seconds` integer, required
    - `metering_interval_seconds` integer, required
  - `delegations` object[], required
    - `lease_id` string, uuid, required: UUIDv7, lowercase canonical form.
    - `host_id` string, uuid, required: UUIDv7, lowercase canonical form.
    - `state` string, required
    - `cpu_seconds` number, required
    - `memory_gib_seconds` number, required
    - `consumed_cpu_seconds` number, required
    - `consumed_memory_gib_seconds` number, required
    - `expires_at` string, date-time, required: RFC 3339 UTC timestamp with Z.

## Other responses

- `4XX`: Default Response
- `5XX`: Default Response

---

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