## Get invoice preview

`ai_gateway.billing.invoice_preview(BillingInvoicePreviewParams**kwargs)  -> BillingInvoicePreviewResponse`

**get** `/accounts/{account_id}/ai-gateway/billing/invoice-preview`

Retrieve a preview of the upcoming invoice including line items and tax.

### Parameters

- `account_id: str`

### Returns

- `class BillingInvoicePreviewResponse: …`

  - `id: str`

  - `amount_due: float`

  - `amount_paid: float`

  - `amount_remaining: float`

  - `currency: str`

  - `invoice_lines: List[InvoiceLine]`

    - `amount: float`

    - `currency: str`

    - `description: Optional[str]`

    - `period: InvoiceLinePeriod`

      - `end: float`

      - `start: float`

    - `pricing: InvoiceLinePricing`

      - `unit_amount_decimal: Optional[str]`

    - `quantity: float`

    - `pretax_credit_amounts: Optional[List[InvoiceLinePretaxCreditAmount]]`

      - `amount: float`

      - `type: str`

      - `credit_balance_transaction: Optional[str]`

      - `discount: Optional[str]`

  - `period_end: float`

  - `period_start: float`

  - `status: Literal["draft", "open", "paid", 2 more]`

    - `"draft"`

    - `"open"`

    - `"paid"`

    - `"uncollectible"`

    - `"void"`

### 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.invoice_preview(
    account_id="account_id",
)
print(response.id)
```

#### Response

```json
{
  "errors": [
    {
      "code": 0,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 0,
      "message": "message"
    }
  ],
  "result": {
    "id": "id",
    "amount_due": 0,
    "amount_paid": 0,
    "amount_remaining": 0,
    "currency": "currency",
    "invoice_lines": [
      {
        "amount": 0,
        "currency": "currency",
        "description": "description",
        "period": {
          "end": 0,
          "start": 0
        },
        "pricing": {
          "unit_amount_decimal": "unit_amount_decimal"
        },
        "quantity": 0,
        "pretax_credit_amounts": [
          {
            "amount": 0,
            "type": "type",
            "credit_balance_transaction": "credit_balance_transaction",
            "discount": "discount"
          }
        ]
      }
    ],
    "period_end": 0,
    "period_start": 0,
    "status": "draft"
  },
  "success": true,
  "result_info": {
    "has_more": true,
    "page": 0,
    "per_page": 0,
    "total_count": 0
  }
}
```