> ## Documentation Index
> Fetch the complete documentation index at: https://docs.microsandbox.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get quota usage



## OpenAPI

````yaml /api-reference/openapi.personal.json get /v1/orgs/{slug}/quotas
openapi: 3.1.0
info:
  title: Personal token API
  description: User-scoped API for account and organization management.
  version: 0.1.0
servers:
  - url: https://api.microsandbox.dev
security:
  - bearer: []
paths:
  /v1/orgs/{slug}/quotas:
    get:
      tags:
        - Quotas
      summary: Get quota usage
      operationId: get_quotas
      parameters:
        - name: slug
          in: path
          description: Organization slug
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Quota usage
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuotaUsage'
        '401':
          description: Unauthorized
        '403':
          description: Not a member
        '404':
          description: Org not found
      security:
        - bearer: []
components:
  schemas:
    QuotaUsage:
      allOf:
        - $ref: '#/components/schemas/PoolUsage'
        - type: object
          required:
            - pool_exhausted
            - total_sandboxes
            - concurrent_ephemeral_running
            - concurrent_persistent_running
            - snapshot_storage_bytes
            - is_suspended
          properties:
            concurrent_ephemeral_running:
              type: integer
              format: int64
              description: Currently running/starting ephemeral sandboxes.
            concurrent_persistent_running:
              type: integer
              format: int64
              description: Currently running/starting persistent sandboxes.
            included_disk_gib_hours:
              type:
                - integer
                - 'null'
              format: int32
              description: >-
                Included writable-disk GiB-hours/month (display/billing only -
                never a wall).
            included_storage_gib:
              type:
                - integer
                - 'null'
              format: int32
              description: Included durable-storage GiB/month.
            is_suspended:
              type: boolean
              description: >-
                Whether sandbox usage has been manually suspended for the
                organization.
            max_concurrent_ephemeral_running:
              type:
                - integer
                - 'null'
              format: int32
              description: Maximum simultaneously-running ephemeral sandboxes.
            max_concurrent_persistent_running:
              type:
                - integer
                - 'null'
              format: int32
              description: Maximum simultaneously-running persistent sandboxes.
            max_disk_size_mib_per_sandbox:
              type:
                - integer
                - 'null'
              format: int32
              description: Maximum writable disk size (MiB) per sandbox.
            max_memory_mib_per_sandbox:
              type:
                - integer
                - 'null'
              format: int32
              description: Maximum memory (MiB) per sandbox.
            max_sandboxes:
              type:
                - integer
                - 'null'
              format: int32
              description: Maximum total sandboxes the org can have.
            max_snapshot_storage_gib:
              type:
                - integer
                - 'null'
              format: int32
              description: Per-org managed-snapshot storage hard cap (GiB).
            max_total_storage_gib:
              type:
                - integer
                - 'null'
              format: int32
              description: Per-org durable-storage hard cap (GiB).
            max_uptime_minutes_per_sandbox:
              type:
                - integer
                - 'null'
              format: int32
              description: Maximum uptime per sandbox (minutes), if set.
            max_vcpus_per_sandbox:
              type:
                - integer
                - 'null'
              format: int32
              description: Maximum CPU cores per sandbox.
            pool_exhausted:
              type: boolean
              description: >-
                Snapshot of [`PoolUsage::pool_exhausted`] at read time, for API

                consumers - true when this org's sandboxes are being stopped and
                starts

                refused.
            snapshot_storage_bytes:
              type: integer
              format: int64
              description: >-
                Exact summed compressed archive size (bytes) of the org's
                managed

                snapshots - the value snapshot quota enforcement compares.
            total_sandboxes:
              type: integer
              format: int64
              description: Total sandboxes (all states) for the org.
      description: >-
        Resolved quota limits and current usage for an organization.


        Limits are resolved via COALESCE: per-org override > plan. Every limit
        is

        `Option`: `None` = unlimited (counts/budgets) or the platform default

        (per-sandbox vCPU/memory/disk). The API materializes resource defaults
        in

        responses. There is no magic 0.
    PoolUsage:
      type: object
      description: >-
        An org's monthly pool usage against its hard-cap pools - the shared home
        of

        the exhaustion predicates, whether read per-org (embedded in
        `QuotaUsage`)

        or in the quota monitor's batched sweep (`OrgPoolUsage`).
      required:
        - hard_cap
        - vcpu_hours_used
        - memory_gib_hours_used
      properties:
        hard_cap:
          type: boolean
          description: >-
            Whether the plan hard-stops at its included pools (no overflow).

            DERIVED (not a stored column): true iff the resolved plan is
            unpriced -

            an unpriced plan has no overage path, so its pools become walls.
        included_memory_gib_hours:
          type:
            - integer
            - 'null'
          format: int32
          description: Included memory GiB-hours/month; `None` = unlimited.
        included_vcpu_hours:
          type:
            - integer
            - 'null'
          format: int32
          description: >-
            Included vCPU-hours/month; `None` = unlimited. On `hard_cap` plans
            this

            is the compute wall; on priced plans, usage beyond it is metered
            overage.
        memory_gib_hours_used:
          type: number
          format: double
          description: >-
            Memory GiB-hours consumed this billing month (compute-on-read from
            `sandbox_runs`).
        vcpu_hours_used:
          type: number
          format: double
          description: >-
            vCPU-hours consumed this billing month (compute-on-read from
            `sandbox_runs`).
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: >-
        Personal access token (msb_pat_…) or session JWT - the credential an
        agent acts with on a user's behalf.

````