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

# list_quotas

List your company's quotas, with filters and pagination.

Each quota carries its measurement type (amount / percentage / float), its
frequency (monthly / quarterly / semesterly / annually) and whether it is
archived.

You only see the quotas you have access to. Each quota also lists the `views`
you can pass as `view` to `list_quota_values` to narrow the rows. Rows are
ordered alphabetically by quota name (A→Z).

## Parameters

<Accordion title="Body" defaultOpen>
  <ParamField body="search" type="string">
    Filter matched against the quota name (case- and accent-insensitive
    substring) or, when it is a valid ObjectId, against the quota id.
  </ParamField>

  <ParamField body="archived" type="boolean">
    When True, return only archived quotas; otherwise only active (non-archived)
    quotas.
  </ParamField>

  <ParamField body="limit" type="integer">
    Page size, between 1 and 250. Defaults to 50.
  </ParamField>

  <ParamField body="offset" type="integer">
    Row offset into the result set — the number of rows to skip before this
    page. Pass the next\_offset returned by the previous call, or None for the
    first page.
  </ParamField>
</Accordion>

## Response

<Accordion title="Body" defaultOpen>
  <ResponseField name="quotas" type="object[]">
    <Expandable title="object properties">
      <ResponseField name="id" type="string" />

      <ResponseField name="resource_url" type="string">
        Deep link to open this quota in the Qobra web app.
      </ResponseField>

      <ResponseField name="name" type="string" />

      <ResponseField name="description" type="string" />

      <ResponseField name="type" type="string">
        Unit of the target value: amount (monetary, has a currency), percentage,
        or float (plain number). One of: `amount`, `percentage`, `float`.
      </ResponseField>

      <ResponseField name="frequency" type="string" />

      <ResponseField name="currency_type" type="string">
        The quota's default currency for amount targets: 'company' (the company
        currency), 'user' (each user's payment currency) or 'calculation' (the
        user's calculation currency). A target value that carries its own
        currency overrides this default. Only meaningful for amount quotas. One
        of: `company`, `user`, `calculation`.
      </ResponseField>

      <ResponseField name="archived" type="boolean" />

      <ResponseField name="views" type="object[]">
        The quota views the caller may query for this quota's values — pass one
        as `view` to list\_quota\_values to narrow the rows. Empty when no view is
        relevant.

        <Expandable title="object properties">
          <ResponseField name="id" type="string" />

          <ResponseField name="name" type="string" />
        </Expandable>
      </ResponseField>
    </Expandable>
  </ResponseField>

  <ResponseField name="next_offset" type="integer" />
</Accordion>