--- title: Billing --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [AI Gateway](https://developers.cloudflare.com/api/python/resources/ai_gateway) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Billing ##### [Get credit balance](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/billing/methods/credit_balance) ai\_gateway.billing.credit\_balance(BillingCreditBalanceParams\*\*kwargs) -> [BillingCreditBalanceResponse]() GET/accounts/{account\_id}/ai-gateway/billing/credit-balance ##### [Get usage history](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/billing/methods/usage_history) ai\_gateway.billing.usage\_history(BillingUsageHistoryParams\*\*kwargs) -> [BillingUsageHistoryResponse]() GET/accounts/{account\_id}/ai-gateway/billing/usage-history ##### [Get invoice history](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/billing/methods/invoice_history) ai\_gateway.billing.invoice\_history(BillingInvoiceHistoryParams\*\*kwargs) -> [BillingInvoiceHistoryResponse]() GET/accounts/{account\_id}/ai-gateway/billing/invoice-history ##### [Get invoice preview](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/billing/methods/invoice_preview) ai\_gateway.billing.invoice\_preview(BillingInvoicePreviewParams\*\*kwargs) -> [BillingInvoicePreviewResponse]() GET/accounts/{account\_id}/ai-gateway/billing/invoice-preview ##### ModelsExpand Collapse

class BillingCreditBalanceResponse: …

balance: float Link to this property has\_default\_payment\_method: bool Link to this property

payment\_method: Optional\[PaymentMethod]

brand: Optional\[str] Link to this property last4: Optional\[str] Link to this property

Link to this property

topup\_config: TopupConfig

amount: Optional\[float] Link to this property threshold: Optional\[float] Link to this property disabled\_reason: Optional\[str] Link to this property error: Optional\[str] Link to this property last\_failed\_at: Optional\[float] Link to this property

Link to this property first\_topup\_success: Optional\[bool] Link to this property

[Link to this property](<#(resource)%20ai_gateway.billing%20%3E%20(model)%20billing_credit_balance_response%20%3E%20(schema)>)

class BillingUsageHistoryResponse: …

history: List\[History]

id: str Link to this property aggregated\_value: float Link to this property end\_time: float Link to this property start\_time: float Link to this property

Link to this property

[Link to this property](<#(resource)%20ai_gateway.billing%20%3E%20(model)%20billing_usage_history_response%20%3E%20(schema)>)

class BillingInvoiceHistoryResponse: …

invoices: List\[Invoice]

amount\_due: float Link to this property amount\_paid: float Link to this property amount\_remaining: float Link to this property currency: str Link to this property id: Optional\[str] Link to this property attempt\_count: Optional\[float] Link to this property attempted: Optional\[bool] Link to this property auto\_advance: Optional\[bool] Link to this property created: Optional\[float] Link to this property created\_by: Optional\[str] Link to this property description: Optional\[str] Link to this property invoice\_origin: Optional\[str] Link to this property invoice\_pdf: Optional\[str] Link to this property status: Optional\[str] Link to this property

Link to this property

pagination: Pagination

has\_more: bool Link to this property page: float Link to this property per\_page: float Link to this property total\_count: float Link to this property

Link to this property

[Link to this property](<#(resource)%20ai_gateway.billing%20%3E%20(model)%20billing_invoice_history_response%20%3E%20(schema)>)

class BillingInvoicePreviewResponse: …

id: str Link to this property amount\_due: float Link to this property amount\_paid: float Link to this property amount\_remaining: float Link to this property currency: str Link to this property

invoice\_lines: List\[InvoiceLine]

amount: float Link to this property currency: str Link to this property description: Optional\[str] Link to this property

period: InvoiceLinePeriod

end: float Link to this property start: float Link to this property

Link to this property

pricing: InvoiceLinePricing

unit\_amount\_decimal: Optional\[str] Link to this property

Link to this property quantity: float Link to this property

pretax\_credit\_amounts: Optional\[List\[InvoiceLinePretaxCreditAmount]]

amount: float Link to this property type: str Link to this property credit\_balance\_transaction: Optional\[str] Link to this property discount: Optional\[str] Link to this property

Link to this property

Link to this property period\_end: float Link to this property period\_start: float Link to this property

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

One of the following: "draft" Link to this property "open" Link to this property "paid" Link to this property "uncollectible" Link to this property "void" Link to this property

Link to this property

[Link to this property](<#(resource)%20ai_gateway.billing%20%3E%20(model)%20billing_invoice_preview_response%20%3E%20(schema)>) #### BillingTopup ##### [Create a top-up](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/billing/subresources/topup/methods/create) ai\_gateway.billing.topup.create(TopupCreateParams\*\*kwargs) -> [TopupCreateResponse]() POST/accounts/{account\_id}/ai-gateway/billing/topup ##### [Check top-up status](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/billing/subresources/topup/methods/status) ai\_gateway.billing.topup.status(TopupStatusParams\*\*kwargs) -> [TopupStatusResponse]() POST/accounts/{account\_id}/ai-gateway/billing/topup/status ##### ModelsExpand Collapse

class TopupCreateResponse: …

client\_secret: Optional\[str] Stripe PaymentIntent client secret. Link to this property onboarding: bool Whether the user was already onboarded. Link to this property payment\_intent\_id: str Stripe invoice ID. Link to this property brand: Optional\[str] Card brand (visa, mastercard, etc.). Link to this property last4: Optional\[str] Last 4 digits of card. Link to this property

[Link to this property](<#(resource)%20ai_gateway.billing.topup%20%3E%20(model)%20topup_create_response%20%3E%20(schema)>)

class TopupStatusResponse: …

payment\_intent\_id: str Link to this property

status: Literal\["completed", "pending"]

One of the following: "completed" Link to this property "pending" Link to this property

Link to this property

[Link to this property](<#(resource)%20ai_gateway.billing.topup%20%3E%20(model)%20topup_status_response%20%3E%20(schema)>) #### BillingTopupConfig ##### [Get auto top-up configuration](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/billing/subresources/topup/subresources/config/methods/get) ai\_gateway.billing.topup.config.get(ConfigGetParams\*\*kwargs) -> [ConfigGetResponse]() GET/accounts/{account\_id}/ai-gateway/billing/topup/config ##### [Set auto top-up configuration](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/billing/subresources/topup/subresources/config/methods/create) ai\_gateway.billing.topup.config.create(ConfigCreateParams\*\*kwargs) -> [ConfigCreateResponse]() POST/accounts/{account\_id}/ai-gateway/billing/topup/config ##### [Delete auto top-up configuration](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/billing/subresources/topup/subresources/config/methods/delete) ai\_gateway.billing.topup.config.delete(ConfigDeleteParams\*\*kwargs) -> object DELETE/accounts/{account\_id}/ai-gateway/billing/topup/config ##### ModelsExpand Collapse

class ConfigGetResponse: …

[Link to this property](<#(resource)%20ai_gateway.billing.topup.config%20%3E%20(model)%20config_get_response%20%3E%20(schema)>)

class ConfigCreateResponse: …

amount: float Link to this property threshold: float Link to this property

[Link to this property](<#(resource)%20ai_gateway.billing.topup.config%20%3E%20(model)%20config_create_response%20%3E%20(schema)>) #### BillingSpending Limit ##### [Get spending limit (deprecated)](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/billing/subresources/spending_limit/methods/get) ai\_gateway.billing.spending\_limit.get(SpendingLimitGetParams\*\*kwargs) -> [SpendingLimitGetResponse]() GET/accounts/{account\_id}/ai-gateway/billing/spending-limit ##### [Set spending limit (deprecated)](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/billing/subresources/spending_limit/methods/create) Deprecated ai\_gateway.billing.spending\_limit.create(SpendingLimitCreateParams\*\*kwargs) -> object POST/accounts/{account\_id}/ai-gateway/billing/spending-limit ##### [Delete spending limit (deprecated)](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/billing/subresources/spending_limit/methods/delete) ai\_gateway.billing.spending\_limit.delete(SpendingLimitDeleteParams\*\*kwargs) -> object DELETE/accounts/{account\_id}/ai-gateway/billing/spending-limit ##### ModelsExpand Collapse

class SpendingLimitGetResponse: …

config: Config

amount: Optional\[float] Link to this property duration: Optional\[str] Link to this property strategy: Optional\[str] Link to this property

Link to this property enabled: bool Link to this property

[Link to this property](<#(resource)%20ai_gateway.billing.spending_limit%20%3E%20(model)%20spending_limit_get_response%20%3E%20(schema)>)