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

# Get Flag Quota

> Report your organization's feature flag allowance

Reports how many flags your organization may define at its current subscription level, and how much of that allowance is in use.

## Authorization

<ParamField header="Authorization" type="string" required>
  Bearer token for authentication. Format: `Bearer <your-api-key>`
</ParamField>

## Required Permission

`FLAGS_READ`

## Response

<ResponseField name="max" type="number">
  Flags allowed at the current subscription level — `5` without a subscription,
  `50` with any active one.
</ResponseField>

<ResponseField name="used" type="number">
  Flags currently defined, archived ones included.
</ResponseField>

<ResponseField name="subscribed" type="boolean">
  Whether the organization has any active subscription. The allowance is a perk
  of being a paying customer, so *any* subscription raises it — not a
  flags-specific one.
</ResponseField>

<ResponseField name="locked" type="number">
  Flags beyond `max`, frozen until the organization subscribes again or removes
  enough flags. Locked flags keep serving their published values; only editing
  them is blocked. See [Feature
  Flags](/cloud/offers/feature-flags#locked-flags).
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.nonefivem.com/cloud/flags/quota" \
    -H "Authorization: Bearer your-api-key"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "max": 50,
    "used": 12,
    "subscribed": true,
    "locked": 0
  }
  ```

  ```json Lapsed subscription theme={null}
  {
    "max": 5,
    "used": 12,
    "subscribed": false,
    "locked": 7
  }
  ```
</ResponseExample>