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

# Get Billing Info

Retrieve comprehensive billing information for your organization, including current plan details, credit balance, and recent transactions.

### Request

<ParamField header="X-Organization-Id" type="string" required>
  The unique identifier of the organization.
</ParamField>

### Response

<ResponseField name="plan" type="object">
  Details about the organization's current billing plan.

  <Expandable title="Plan Details">
    <ResponseField name="name" type="string">The name of the plan (e.g., `starter`, `pro`).</ResponseField>
    <ResponseField name="platform_fee" type="number">Platform fee per minute in USD.</ResponseField>
    <ResponseField name="concurrent_calls" type="number">Maximum number of concurrent calls allowed.</ResponseField>
    <ResponseField name="included_kb_pages_per_month" type="number">Number of knowledge base pages included per month.</ResponseField>
    <ResponseField name="retention_days" type="number">Number of days call recordings are retained.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="credits" type="object">
  Information about available credits.

  <Expandable title="Credit Details">
    <ResponseField name="balance" type="number">Current available balance.</ResponseField>
    <ResponseField name="currency" type="string">Currency code (e.g., `USD`).</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="subscription" type="object">
  Subscription status and details.

  <Expandable title="Subscription Details">
    <ResponseField name="status" type="string">Current subscription status.</ResponseField>
    <ResponseField name="next_billing_date" type="string">Date of the next billing cycle.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="transaction_summary" type="object">
  Summary of recent billing transactions.
</ResponseField>

<ResponseField name="recent_transactions" type="array">
  List of the 10 most recent transactions.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "plan": {
      "name": "starter",
      "platform_fee": 0.03,
      "concurrent_calls": 5,
      "included_kb_pages_per_month": 100,
      "retention_days": 30,
      "snapshot": {}
    },
    "kb_usage": {
      "pages_used_this_month": 10,
      "pages_included": 100,
      "kb_usage_period": "2024-03",
      "pages_remaining": 90,
      "pages_overage": 0
    },
    "subscription": {
      "status": "active",
      "next_billing_date": "2024-04-01T00:00:00Z",
      "dodo_subscription_id": "sub_xyz789",
      "dodo_customer_id": "cus_abc123"
    },
    "credits": {
      "balance": 500,
      "currency": "USD",
      "low_balance_threshold": 10,
      "last_updated": "2024-03-01T12:00:00Z",
      "last_transaction_id": "txn_def456"
    },
    "transaction_summary": {
      "total_credits_added": 1000,
      "total_credits_used": 500,
      "net_balance": 500,
      "transaction_count": 5
    },
    "recent_transactions": []
  }
  ```
</ResponseExample>