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

# Get organization quotas

> **Disclaimer:** This beta endpoint is evolving; the API contract may change. <br /><br /> Returns the resource quotas enforced for the organization together with their current usage where available. Quotas that do not apply to the organization are omitted. Quota values reflect the limits currently enforced, so they can be polled to detect changes, for example after a billing status change. The response contains one entry per quota code; quotas enforced per resource may additionally appear under resource-scoped endpoints in the future.

<span data-endpoint-badge="Beta"><Badge color="blue">Beta</Badge></span>

**Disclaimer:** This beta endpoint is evolving; the API contract may change. <br /><br /> Returns the resource quotas enforced for the organization together with their current usage where available. Quotas that do not apply to the organization are omitted. Quota values reflect the limits currently enforced, so they can be polled to detect changes, for example after a billing status change. The response contains one entry per quota code; quotas enforced per resource may additionally appear under resource-scoped endpoints in the future.


## OpenAPI

````yaml _specs/cloud-openapi.json GET /v1/organizations/{organizationId}/quotas
openapi: 3.1.2
info:
  title: OpenAPI spec for ClickHouse Cloud
  version: '1.0'
  contact:
    name: ClickHouse Support
    url: >-
      https://clickhouse.com/docs/en/cloud/manage/openapi?referrer=openapi-1062602
    email: support@clickhouse.com
servers:
  - url: https://api.clickhouse.cloud
security:
  - basicAuth: []
tags:
  - name: Organization
  - name: User management
  - name: Billing
  - name: Role Management
  - name: Service
  - name: Backup
  - name: OpenAPI
  - name: Prometheus
  - name: ClickPipes
  - name: ClickStack
  - name: Postgres
paths:
  /v1/organizations/{organizationId}/quotas:
    get:
      tags:
        - Organization
      summary: Get organization quotas
      description: >-
        **Disclaimer:** This beta endpoint is evolving; the API contract may
        change. <br /><br /> Returns the resource quotas enforced for the
        organization together with their current usage where available. Quotas
        that do not apply to the organization are omitted. Quota values reflect
        the limits currently enforced, so they can be polled to detect changes,
        for example after a billing status change. The response contains one
        entry per quota code; quotas enforced per resource may additionally
        appear under resource-scoped endpoints in the future.
      operationId: organizationQuotasGetList
      parameters:
        - in: path
          name: organizationId
          description: ID of the requested organization.
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: number
                    description: HTTP status code.
                    example: 200
                  requestId:
                    type: string
                    description: Unique id assigned to every request. UUIDv4
                    format: uuid
                  result:
                    type: array
                    items:
                      $ref: '#/components/schemas/OrganizationQuota'
        '400':
          description: >-
            The request cannot be processed due to a client error. Please verify
            your request parameters and try again.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: number
                    description: HTTP status code.
                    example: 400
                  error:
                    type: string
                    description: Detailed error description.
                  requestId:
                    type: string
                    description: Unique id assigned to every request. UUIDv4
                    format: uuid
        '500':
          description: >-
            An internal server error has occurred. If this issue persists,
            please contact ClickHouse Cloud support for assistance.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    description: HTTP status code.
                    example: 500
                  error:
                    type: string
                    description: Detailed error description.
                  requestId:
                    type: string
                    description: Unique id assigned to every request. UUIDv4
                    format: uuid
components:
  schemas:
    OrganizationQuota:
      properties:
        quotaCode:
          description: >-
            Stable identifier of the quota. Use it to request a single quota by
            code.
          type: string
          enum:
            - services-per-organization
            - postgres-services-per-organization
            - replicas-per-warehouse
          example: services-per-organization
        name:
          description: Human-readable name of the quota.
          type: string
          example: Services per organization
        description:
          description: >-
            Explanation of the resource the quota limits and how the limit is
            applied.
          type: string
        scope:
          description: >-
            Granularity at which the limit is applied. For example,
            `replicas-per-warehouse` is an organization-wide setting that limits
            each warehouse individually.
          type: string
          enum:
            - organization
            - warehouse
          example: organization
        value:
          description: >-
            Limit currently applied to the organization, including any
            adjustments made for the organization. The value can change when the
            billing status of the organization changes.
          type: integer
          minimum: 0
          example: 20
        usage:
          description: >-
            Current consumption of the quota. Omitted for quotas that do not
            report usage. Usage can exceed `value` when a limit was lowered
            after resources were created; existing resources are not affected.
          type: integer
          minimum: 0
          example: 3
        adjustable:
          description: >-
            Whether the limit can be raised for the organization by contacting
            ClickHouse support.
          type: boolean
      required:
        - quotaCode
        - name
        - description
        - scope
        - value
        - adjustable
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Use key ID and key secret obtained in ClickHouse Cloud console:
        https://clickhouse.com/docs/cloud/manage/openapi

````