---
title: "List organisation quotas and tier defaults"
method: GET
path: "/api/v1/orgs/quotas"
tags: ["org-quotas"]
---

# List organisation quotas and tier defaults

`GET /api/v1/orgs/quotas`

## Request

- Base URL: `https://api.qualityclouds.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.qualityclouds.ai/api/v1/orgs/quotas`
- Auth: one of:
  - HTTP bearer
  - OpenID Connect (`https://account.qualityclouds.com//realms/ai-production/.well-known/openid-configuration`)

## Query parameters

- `org_id` string, required: Keycloak organisation id (must appear in the JWT org_ids claim)

## Response `200`

Successful Response

- OrgQuotasResponse
  - `organisation_id` string, required
  - `tier` string, required
  - `tier_defaults` TierDefaultResponse[], required
    - `quota_key` string, required
    - `max_allowed` integer, required
    - `reset_period` string, nullable, required
  - `quotas` OrgQuotaItemResponse[], required
    - `quota_key` string, required
    - `tier_default` TierDefaultResponse, required
      - `quota_key` string, required
      - `max_allowed` integer, required
      - `reset_period` string, nullable, required
    - `organisation_quota` OrganisationQuotaResponse, required
      - `id` string, uuid, required
      - `organisation_id` string, uuid, required
      - `quota_key` string, required
      - `max_allowed` integer, required
      - `current_usage` integer, required
      - `reset_period` string, nullable, required
      - `period_start` string, date-time, nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `used_vs_available` string, required
    - `available` boolean, required
    - `reset_at` string, date-time, nullable, required
    - `scans_reward` integer, nullable
  - `billing_status` BillingStatusResponse: Optional billing state block; only returned to org_admin for the requested org.
    - `status` string, required
    - `current_period_end` string, date-time, nullable, required
    - `grace_period_ends_at` string, date-time, nullable, required
    - `will_cancel` boolean
    - `effective_cancellation_date` string, date-time, nullable
    - `renewal_date` string, date-time, nullable
  - `price_amount` integer, nullable
  - `currency` string, nullable
  - `billing_mode` string

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error

---

[API](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api.md) · [All operations](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/revisions/250c849925af?raw)