--- title: Billing --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [AI Gateway](https://developers.cloudflare.com/api/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/resources/ai_gateway/subresources/billing/methods/credit_balance) GET/accounts/{account\_id}/ai-gateway/billing/credit-balance ##### [Get usage history](https://developers.cloudflare.com/api/resources/ai_gateway/subresources/billing/methods/usage_history) GET/accounts/{account\_id}/ai-gateway/billing/usage-history ##### [Get invoice history](https://developers.cloudflare.com/api/resources/ai_gateway/subresources/billing/methods/invoice_history) GET/accounts/{account\_id}/ai-gateway/billing/invoice-history ##### [Get invoice preview](https://developers.cloudflare.com/api/resources/ai_gateway/subresources/billing/methods/invoice_preview) GET/accounts/{account\_id}/ai-gateway/billing/invoice-preview ##### ModelsExpand Collapse

BillingCreditBalanceResponse object {balance, has\_default\_payment\_method, payment\_method, 2 more }

balance: number Link to this property has\_default\_payment\_method: boolean Link to this property

payment\_method: object {brand, last4 }

brand: optional string Link to this property last4: optional string Link to this property

Link to this property

topup\_config: object {amount, threshold, disabledReason, 2 more }

amount: number Link to this property threshold: number Link to this property disabledReason: optional string Link to this property error: optional string Link to this property lastFailedAt: optional number Link to this property

Link to this property first\_topup\_success: optional boolean Link to this property

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

BillingUsageHistoryResponse object {history }

history: array of object {id, aggregated\_value, end\_time, start\_time }

id: string Link to this property aggregated\_value: number Link to this property end\_time: number Link to this property start\_time: number 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)>)

BillingInvoiceHistoryResponse object {invoices, pagination }

invoices: array of object {amount\_due, amount\_paid, amount\_remaining, 11 more }

amount\_due: number Link to this property amount\_paid: number Link to this property amount\_remaining: number Link to this property currency: string Link to this property id: optional string Link to this property attempt\_count: optional number Link to this property attempted: optional boolean Link to this property auto\_advance: optional boolean Link to this property created: optional number Link to this property created\_by: optional string Link to this property description: optional string Link to this property invoice\_origin: optional string Link to this property invoice\_pdf: optional string Link to this property status: optional string Link to this property

Link to this property

pagination: object {has\_more, page, per\_page, total\_count }

has\_more: boolean Link to this property page: number Link to this property per\_page: number Link to this property total\_count: number 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)>)

BillingInvoicePreviewResponse object {id, amount\_due, amount\_paid, 6 more }

id: string Link to this property amount\_due: number Link to this property amount\_paid: number Link to this property amount\_remaining: number Link to this property currency: string Link to this property

invoice\_lines: array of object {amount, currency, description, 4 more }

amount: number Link to this property currency: string Link to this property description: string Link to this property

period: object {end, start }

end: number Link to this property start: number Link to this property

Link to this property

pricing: object {unit\_amount\_decimal }

unit\_amount\_decimal: string Link to this property

Link to this property quantity: number Link to this property

pretax\_credit\_amounts: optional array of object {amount, type, credit\_balance\_transaction, discount }

amount: number Link to this property type: string Link to this property credit\_balance\_transaction: optional string Link to this property discount: optional string Link to this property

Link to this property

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

status: "draft"or "open"or "paid"or 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/resources/ai_gateway/subresources/billing/subresources/topup/methods/create) POST/accounts/{account\_id}/ai-gateway/billing/topup ##### [Check top-up status](https://developers.cloudflare.com/api/resources/ai_gateway/subresources/billing/subresources/topup/methods/status) POST/accounts/{account\_id}/ai-gateway/billing/topup/status ##### ModelsExpand Collapse

TopupCreateResponse object {client\_secret, onboarding, payment\_intent\_id, 2 more }

client\_secret: string Stripe PaymentIntent client secret. Link to this property onboarding: boolean Whether the user was already onboarded. Link to this property payment\_intent\_id: string Stripe invoice ID. Link to this property brand: optional string Card brand (visa, mastercard, etc.). Link to this property last4: optional string 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)>)

TopupStatusResponse object {payment\_intent\_id, status }

payment\_intent\_id: string Link to this property

status: "completed"or "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/resources/ai_gateway/subresources/billing/subresources/topup/subresources/config/methods/get) GET/accounts/{account\_id}/ai-gateway/billing/topup/config ##### [Set auto top-up configuration](https://developers.cloudflare.com/api/resources/ai_gateway/subresources/billing/subresources/topup/subresources/config/methods/create) POST/accounts/{account\_id}/ai-gateway/billing/topup/config ##### [Delete auto top-up configuration](https://developers.cloudflare.com/api/resources/ai_gateway/subresources/billing/subresources/topup/subresources/config/methods/delete) DELETE/accounts/{account\_id}/ai-gateway/billing/topup/config ##### ModelsExpand Collapse

ConfigGetResponse object {amount, threshold, disabledReason, 2 more }

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

ConfigCreateResponse object {amount, threshold }

amount: number Link to this property threshold: number 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)>) ConfigDeleteResponse = unknown [Link to this property](<#(resource)%20ai_gateway.billing.topup.config%20%3E%20(model)%20config_delete_response%20%3E%20(schema)>) #### BillingSpending Limit ##### [Get spending limit (deprecated)](https://developers.cloudflare.com/api/resources/ai_gateway/subresources/billing/subresources/spending_limit/methods/get) GET/accounts/{account\_id}/ai-gateway/billing/spending-limit ##### [Set spending limit (deprecated)](https://developers.cloudflare.com/api/resources/ai_gateway/subresources/billing/subresources/spending_limit/methods/create) Deprecated POST/accounts/{account\_id}/ai-gateway/billing/spending-limit ##### [Delete spending limit (deprecated)](https://developers.cloudflare.com/api/resources/ai_gateway/subresources/billing/subresources/spending_limit/methods/delete) DELETE/accounts/{account\_id}/ai-gateway/billing/spending-limit ##### ModelsExpand Collapse

SpendingLimitGetResponse object {config, enabled }

config: object {amount, duration, strategy }

amount: number Link to this property duration: string Link to this property strategy: string Link to this property

Link to this property enabled: boolean 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)>) SpendingLimitCreateResponse = unknown [Link to this property](<#(resource)%20ai_gateway.billing.spending_limit%20%3E%20(model)%20spending_limit_create_response%20%3E%20(schema)>) SpendingLimitDeleteResponse = unknown [Link to this property](<#(resource)%20ai_gateway.billing.spending_limit%20%3E%20(model)%20spending_limit_delete_response%20%3E%20(schema)>)