## Get credit balance

`ai_gateway.billing.credit_balance(BillingCreditBalanceParams**kwargs)  -> BillingCreditBalanceResponse`

**get** `/accounts/{account_id}/ai-gateway/billing/credit-balance`

Retrieve the current credit balance, payment method info, and top-up configuration.

### Parameters

- `account_id: str`

### Returns

- `class BillingCreditBalanceResponse: …`

  - `balance: float`

  - `has_default_payment_method: bool`

  - `payment_method: Optional[PaymentMethod]`

    - `brand: Optional[str]`

    - `last4: Optional[str]`

  - `topup_config: TopupConfig`

    - `amount: Optional[float]`

    - `disabled_reason: Optional[str]`

    - `error: Optional[str]`

    - `last_failed_at: Optional[float]`

    - `threshold: Optional[float]`

  - `first_topup_success: Optional[bool]`

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
response = client.ai_gateway.billing.credit_balance(
    account_id="account_id",
)
print(response.balance)
```

#### Response

```json
{
  "errors": [
    {
      "code": 0,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 0,
      "message": "message"
    }
  ],
  "result": {
    "balance": 0,
    "has_default_payment_method": true,
    "payment_method": {
      "brand": "brand",
      "last4": "last4"
    },
    "topup_config": {
      "amount": 0,
      "disabledReason": "disabledReason",
      "error": "error",
      "lastFailedAt": 0,
      "threshold": 0
    },
    "first_topup_success": true
  },
  "success": true,
  "result_info": {
    "has_more": true,
    "page": 0,
    "per_page": 0,
    "total_count": 0
  }
}
```