> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Get organization quota details > **Disclaimer:** This beta endpoint is evolving; the API contract may change.

Returns a single organization quota identified by its quota code. Responds with a not found error when the quota code is unknown or the quota does not apply to the organization. Beta **Disclaimer:** This beta endpoint is evolving; the API contract may change.

Returns a single organization quota identified by its quota code. Responds with a not found error when the quota code is unknown or the quota does not apply to the organization.

Permission

The API key must have the `control-plane:organization:view` permission.
## OpenAPI ````yaml _specs/cloud-openapi.json GET /v1/organizations/{organizationId}/quotas/{quotaCode} openapi: 3.1.1 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-1222280 email: support@clickhouse.com servers: - url: https://api.clickhouse.cloud security: - basicAuth: [] tags: - name: Organization - name: Notifications - name: User management - name: Billing - name: Role Management - name: Service - name: Backup - name: Snapshot - name: API keys - name: Prometheus - name: ClickPipes - name: ClickStack - name: Postgres - name: UDF - name: Query API endpoints - name: Saved queries paths: /v1/organizations/{organizationId}/quotas/{quotaCode}: get: tags: - Organization summary: Get organization quota details description: >- **Disclaimer:** This beta endpoint is evolving; the API contract may change.

Returns a single organization quota identified by its quota code. Responds with a not found error when the quota code is unknown or the quota does not apply to the organization. operationId: organizationQuotaGet parameters: - in: path name: organizationId description: ID of the requested organization. required: true schema: type: string format: uuid - in: path name: quotaCode description: Code of the requested quota. required: true schema: type: string 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: $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 - api-keys-per-organization 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 x-permission-scopes: >- The scope list of a `security` requirement holds ClickHouse Cloud API key permission ids (for example `control-plane:organization:view`), not OAuth scopes. OpenAPI has no field for API key permissions, so this is the closest available place. A key must hold every permission listed on an operation to call it; an operation with no scopes needs none beyond a valid key. Every operation declares at most one requirement object, always for this scheme, so the list is only ever conjunctive — alternative sets of permissions are never expressed. ````