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

# List plans

> List the subscription plans of your white label platform

This endpoint returns your subscription plans, as on the **Plans** page of your administration panel, with the minutes each plan takes from your balance when you give it to a user with [Update user plan](/api-reference/white-label/update-user-plan).

<Note>
  This endpoint is available to the **account owner** (with an active plan) and to team members with **Billing Access**. Other users receive a 403 Forbidden error.
</Note>

### Response

<ResponseField name="currency" type="string">
  The currency of your prices, for example `USD`
</ResponseField>

<ResponseField name="data" type="object[]">
  Your plans, in the order of your plans page

  <Expandable title="plan properties">
    <ResponseField name="id" type="integer">
      The plan's ID
    </ResponseField>

    <ResponseField name="name" type="string">
      The plan's name
    </ResponseField>

    <ResponseField name="description" type="string">
      The plan's description
    </ResponseField>

    <ResponseField name="active" type="boolean">
      Whether your users see the plan on the plans page. Inactive plans can still be given to a user, or shown to one user with `visible_plans` in [Update user settings](/api-reference/white-label/update-user-settings)
    </ResponseField>

    <ResponseField name="included_minutes" type="number">
      The minutes included in the plan every month
    </ResponseField>

    <ResponseField name="included_credits" type="integer">
      The chat credits included in the plan every month, for AI replies, WhatsApp and SMS
    </ResponseField>

    <ResponseField name="extra_minutes_cost" type="number">
      The price per minute after the included minutes, in `currency`
    </ResponseField>

    <ResponseField name="prices" type="object[]">
      The plan's prices: `billing` (`monthly` or `yearly`) and `amount`, in `currency`
    </ResponseField>

    <ResponseField name="cost_in_minutes" type="number">
      The minutes taken from the owner's balance when you give this plan to a user with monthly minutes: its included minutes, plus its chat credits at 9 credits per minute. Yearly minutes take 12 times this, and a plan without minutes takes nothing
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "currency": "USD",
    "data": [
      {
        "id": 5,
        "name": "Starter",
        "description": "For small teams getting started",
        "active": true,
        "included_minutes": 100,
        "included_credits": 0,
        "extra_minutes_cost": 0.2,
        "prices": [
          { "billing": "monthly", "amount": 29 },
          { "billing": "yearly", "amount": 290 }
        ],
        "cost_in_minutes": 100
      },
      {
        "id": 6,
        "name": "Agency",
        "description": "For agencies with several clients",
        "active": true,
        "included_minutes": 500,
        "included_credits": 900,
        "extra_minutes_cost": 0.15,
        "prices": [
          { "billing": "monthly", "amount": 99 }
        ],
        "cost_in_minutes": 600
      }
    ]
  }
  ```

  ```json 401 Unauthenticated theme={null}
  {
    "message": "Unauthenticated."
  }
  ```

  ```json 403 Not Administrator theme={null}
  {
    "message": "You are not an administrator."
  }
  ```

  ```json 403 No Billing Access theme={null}
  {
    "message": "You do not have access to these settings."
  }
  ```

  ```json 429 Too Many Requests theme={null}
  {
    "message": "Too Many Attempts."
  }
  ```
</ResponseExample>

### Rate limit

The platform settings, default limits, user settings and plan endpoints share a limit of 60 requests per minute for each account. Above it they return `429`, and the `Retry-After` response header tells you how many seconds to wait.

### Example

```bash theme={null}
curl -X GET https://app.autocalls.ai/api/white-label/plans \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.