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

# Get Account Limits

> Your plan, what it allows, and how much of it is in use

Check this before creating links in bulk: it shows how many deeplinks and websites the account can still create, how many can be active, and which redirect behaviors the plan allows. A limit of `-1` means unlimited.

## Request

### Headers

## Response

<ResponseField name="success" type="boolean">
  Always `true` on success
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="properties">
    <ResponseField name="plan" type="string">
      Plan id, e.g. `free`, `solo`, `growth`, `scaling`, `dominance`
    </ResponseField>

    <ResponseField name="eligibleForApi" type="boolean">
      Whether the plan includes API access (Growth and above, the plans that can create API keys and connect AI apps)
    </ResponseField>

    <ResponseField name="links" type="object">
      Deeplinks and websites together: `active` and `total` in use, `activeLimit` and `totalLimit` (`-1` = unlimited). At the total limit new links are refused; at the active limit new links are created inactive
    </ResponseField>

    <ResponseField name="customDomains" type="object">
      `used` and `limit` (`-1` = unlimited, which every paid plan includes)
    </ResponseField>

    <ResponseField name="behaviors" type="array">
      Redirect behaviors the plan can save. Free plans can only use `conservative`
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.bouncy.ai/v1/account/limits \
    -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.bouncy.ai/v1/account/limits', {
    headers: { 'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY' }
  });

  const { data } = await response.json();
  const left = data.links.totalLimit === -1 ? Infinity : data.links.totalLimit - data.links.total;
  console.log(`${left} more links can be created on the ${data.plan} plan`);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.bouncy.ai/v1/account/limits',
      headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
  )

  data = response.json()['data']
  print(data['plan'], data['links'])
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "success": true,
    "data": {
      "plan": "growth",
      "eligibleForApi": true,
      "links": { "active": 4, "total": 9, "activeLimit": 5, "totalLimit": 10 },
      "customDomains": { "used": 2, "limit": -1 },
      "behaviors": ["conservative", "aggressive", "basic", "non-meta", "experimental", "experimental2", "reddit"]
    }
  }
  ```
</ResponseExample>