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

# List Credit Bundles

> List available credit bundles that can be purchased as one-time add-ons. Purchased credits roll over and never expire.

<RequestExample>
  ```typescript TypeScript theme={null}
  import { CommuneClient } from 'commune-ai';

  const commune = new CommuneClient({ apiKey: process.env.COMMUNE_API_KEY });

  const bundles = await commune.credits.listBundles();

  for (const bundle of bundles) {
    console.log(`${bundle.id}: ${bundle.credits} credits for $${bundle.price}`);
    console.log(`  $${bundle.price_per_credit} per credit`);
  }
  ```

  ```python Python theme={null}
  from commune import CommuneClient

  client = CommuneClient()

  bundles = client.credits.list_bundles()

  for bundle in bundles:
      print(f"{bundle.id}: {bundle.credits} credits for ${bundle.price}")
      print(f"  ${bundle.price_per_credit} per credit")
  ```

  ```bash MCP theme={null}
  list_credit_bundles()
  ```

  ```bash cURL theme={null}
  curl https://api.commune.email/v1/credits/bundles \
    -H "Authorization: Bearer comm_..."
  ```

  ```bash CLI theme={null}
  commune credits bundles
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "data": [
      {
        "id": "starter",
        "credits": 1000,
        "price": 12,
        "price_per_credit": "0.0120"
      },
      {
        "id": "growth",
        "credits": 5000,
        "price": 55,
        "price_per_credit": "0.0110"
      },
      {
        "id": "scale",
        "credits": 20000,
        "price": 200,
        "price_per_credit": "0.0100"
      }
    ]
  }
  ```
</ResponseExample>

## Response

<ResponseField name="data" type="CreditBundle[]">
  Array of all available credit bundles.

  <Expandable title="CreditBundle properties" defaultOpen>
    <ResponseField name="id" type="string">
      Bundle identifier. One of: `starter`, `growth`, `scale`. Use this ID in the purchase endpoint.
    </ResponseField>

    <ResponseField name="credits" type="number">
      Number of credits included in this bundle.
    </ResponseField>

    <ResponseField name="price" type="number">
      Price in USD for this bundle (one-time payment).
    </ResponseField>

    <ResponseField name="price_per_credit" type="string">
      Cost per credit formatted as a decimal string (e.g., `"0.0120"`).
    </ResponseField>
  </Expandable>
</ResponseField>

<Note>
  Larger bundles offer better per-credit pricing:

  * Starter (1,000 credits): \$0.0120/credit
  * Growth (5,000 credits): \$0.0110/credit
  * Scale (20,000 credits): \$0.0100/credit

  Purchased credits roll over month-to-month and do not expire.
</Note>


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