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

# Get quotas

> Get the organization's quotas. Each key of `quotas` holds its `limit` and current `usage`. `max_gpus_per_instance`, the largest GPU count one instance may have, caps each instance on its own, so it has a `limit` and no `usage`.

Usage is counted when the request is made. The GPU quotas count GPUs on running instances and running sandboxes together; a queued, building or starting resource already counts. `instances` counts every instance that is not deleted, running or stopped. The sandbox quotas (`sandboxes`, `sandbox_memory_gib`) are always present in `quotas`, 0 when the organization has none. The organization has Sandbox access exactly when `quotas.sandboxes.limit` is above 0.

`standard_gpu_types` lists the GPU types that count toward `standard_gpus`; every other GPU type counts toward `premium_gpus`. With `usage=false` the response holds limits only: no usage is counted and no quota has `usage`.

`tier` is the organization's quota tier, which decides every limit the organization has no override for. `overrides` lists the limit keys the organization has its own override for, in a fixed order, and is an empty array when it has none. A first successful payment moves an organization on the `student` or `new` tier to a paid tier, which raises each limit the paid tier sets higher, except the keys in `overrides`; any other limit is raised only by support.



## OpenAPI

````yaml https://api.thundercompute.com:8443/openapi.json get /quotas
openapi: 3.1.0
info:
  contact:
    email: support@thundercompute.com
    name: Thunder Compute API Support
    url: https://thundercompute.com/support
  description: >-
    Retrieve current GPU availability using mode-less spec keys

    Recommended for new integrations. The /status and /v1/status endpoints
    retain their legacy configuration keys for compatibility.
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: http://swagger.io/terms/
  title: Thunder Compute API
  version: '1.0'
servers:
  - description: Production server
    url: https://api.thundercompute.com:8443/v1
  - description: Production server
    url: https://api.thundercompute.com:8443
security: []
externalDocs:
  description: ''
  url: ''
paths:
  /quotas:
    get:
      tags:
        - Utilities
      summary: Get quotas
      description: >-
        Get the organization's quotas. Each key of `quotas` holds its `limit`
        and current `usage`. `max_gpus_per_instance`, the largest GPU count one
        instance may have, caps each instance on its own, so it has a `limit`
        and no `usage`.


        Usage is counted when the request is made. The GPU quotas count GPUs on
        running instances and running sandboxes together; a queued, building or
        starting resource already counts. `instances` counts every instance that
        is not deleted, running or stopped. The sandbox quotas (`sandboxes`,
        `sandbox_memory_gib`) are always present in `quotas`, 0 when the
        organization has none. The organization has Sandbox access exactly when
        `quotas.sandboxes.limit` is above 0.


        `standard_gpu_types` lists the GPU types that count toward
        `standard_gpus`; every other GPU type counts toward `premium_gpus`. With
        `usage=false` the response holds limits only: no usage is counted and no
        quota has `usage`.


        `tier` is the organization's quota tier, which decides every limit the
        organization has no override for. `overrides` lists the limit keys the
        organization has its own override for, in a fixed order, and is an empty
        array when it has none. A first successful payment moves an organization
        on the `student` or `new` tier to a paid tier, which raises each limit
        the paid tier sets higher, except the keys in `overrides`; any other
        limit is raised only by support.
      parameters:
        - description: Count current usage; false returns limits only
          in: query
          name: usage
          schema:
            default: true
            type: boolean
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/thundertypes.QuotasResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/thundertypes.ErrorResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/thundertypes.ErrorResponse'
          description: Unauthorized
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/thundertypes.ErrorResponse'
          description: Service Unavailable
      security:
        - ApiKeyAuth: []
components:
  schemas:
    thundertypes.QuotasResponse:
      properties:
        overrides:
          description: >-
            Overrides lists the limit keys the organization has its own override

            for, in a fixed order; empty, never null, when it has none. Those

            limits do not follow the tier, so only support raises them. It is an

            open list of strings, not an enum: a later version may add a key,
            which

            callers should ignore if they do not know it.
          example:
            - sandboxes
          items:
            type: string
          type: array
          uniqueItems: false
        quotas:
          $ref: '#/components/schemas/thundertypes.Quotas'
          description: >-
            Quotas are the organization's quotas, each with the limit enforced
            and

            its current usage.
        standard_gpu_types:
          description: >-
            StandardGPUTypes are the GPU types that count toward standard_gpus,

            lower case and sorted. Every other GPU type counts toward
            premium_gpus.
          example:
            - a100
            - a100xl
            - a6000
            - l40
            - l40s
            - t4
          items:
            type: string
          type: array
          uniqueItems: false
        tier:
          description: >-
            Tier is the organization's quota tier, which decides every limit the

            organization has no override for. A first successful payment moves
            an

            organization off the student and new tiers. It is an open string,
            not

            an enum: support can put an organization on a tier of its own.
          example: verified
          type: string
      type: object
    thundertypes.ErrorResponse:
      properties:
        code:
          example: 400
          type: integer
        error:
          example: invalid_request
          type: string
        message:
          example: The request is malformed
          type: string
      type: object
    thundertypes.Quotas:
      properties:
        instances:
          $ref: '#/components/schemas/thundertypes.Quota'
        max_gpus_per_instance:
          $ref: '#/components/schemas/thundertypes.Quota'
          description: >-
            MaxGPUsPerInstance is the largest GPU count one instance may have.
            It

            caps each instance on its own, so it has no usage.
        premium_gpus:
          $ref: '#/components/schemas/thundertypes.Quota'
        sandbox_memory_gib:
          $ref: '#/components/schemas/thundertypes.Quota'
          description: >-
            SandboxMemoryGiB is the memory its running sandboxes may hold in
            total.
        sandboxes:
          $ref: '#/components/schemas/thundertypes.Quota'
          description: >-
            Sandboxes is how many sandboxes the organization may run at once.
            The

            organization has Sandbox access exactly when its limit is above 0.
        standard_gpus:
          $ref: '#/components/schemas/thundertypes.Quota'
      type: object
    thundertypes.Quota:
      properties:
        limit:
          example: 16
          type: integer
        usage:
          description: >-
            Usage is absent for max_gpus_per_instance, which has none, and when
            the

            request asked for limits only (usage=false).
          example: 3
          type: integer
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: >-
        Bearer token authentication. Provide your API token prefixed with
        "Bearer ", e.g. "Bearer your-api-token".
      in: header
      name: Authorization
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.