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

# Get Balance

> Retrieve your current account balance and billing details.

## Response Fields

<ResponseField name="success" type="boolean">
  Whether the request was successful.
</ResponseField>

<ResponseField name="data" type="object">
  Account balance details.

  <Expandable title="data properties">
    <ResponseField name="data.balance" type="number">
      Current available balance in USD (e.g. `45.00`).
    </ResponseField>

    <ResponseField name="data.billingMode" type="string">
      Billing mode. One of: `prepaid` (top-up balance), `postpaid` (card on file, invoiced monthly).
    </ResponseField>

    <ResponseField name="data.monthlySpendLimit" type="number | null">
      Monthly spending limit. `null` if not set.
    </ResponseField>

    <ResponseField name="data.autoTopUpEnabled" type="boolean">
      Whether automatic top-up is enabled.
    </ResponseField>

    <ResponseField name="data.autoTopUpThreshold" type="number | null">
      Balance threshold that triggers auto top-up. `null` if not configured.
    </ResponseField>

    <ResponseField name="data.autoTopUpAmount" type="number | null">
      Amount to add when auto top-up is triggered. `null` if not configured.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "balance": 45.00,
      "billingMode": "prepaid",
      "monthlySpendLimit": null,
      "autoTopUpEnabled": false,
      "autoTopUpThreshold": null,
      "autoTopUpAmount": null
    }
  }
  ```
</ResponseExample>