--- title: Get invoice history --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [AI Gateway](https://developers.cloudflare.com/api/python/resources/ai_gateway) [Billing](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/billing) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get invoice history ai\_gateway.billing.invoice\_history(BillingInvoiceHistoryParams\*\*kwargs) -> [BillingInvoiceHistoryResponse]() GET/accounts/{account\_id}/ai-gateway/billing/invoice-history Retrieve a list of past invoices with pagination, optionally filtered by type. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `AI Gateway Write``AI Gateway Read` ##### ParametersExpand Collapse account\_id: str [Link to this property](<#(resource)%20ai_gateway.billing%20%3E%20(method)%20invoice_history%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)
type: Optional\[Literal\["auto", "all", "manual"]] Filter invoice type: auto, manual, or all. One of the following: "auto" Link to this property "all" Link to this property "manual" Link to this property
[Link to this property](<#(resource)%20ai_gateway.billing%20%3E%20(method)%20invoice_history%20%3E%20(params)%20default%20%3E%20(param)%20type%20%3E%20(schema)>) ##### ReturnsExpand Collapse
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)>) ### Get invoice history Python HTTPTypeScriptPythonGoTerraform ``` 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_history( account_id="account_id", ) print(response.invoices) ``` 200 example ``` { "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ], "result": { "invoices": [ { "amount_due": 0, "amount_paid": 0, "amount_remaining": 0, "currency": "currency", "id": "id", "attempt_count": 0, "attempted": true, "auto_advance": true, "created": 0, "created_by": "created_by", "description": "description", "invoice_origin": "invoice_origin", "invoice_pdf": "invoice_pdf", "status": "status" } ], "pagination": { "has_more": true, "page": 0, "per_page": 0, "total_count": 0 } }, "success": true, "result_info": { "has_more": true, "page": 0, "per_page": 0, "total_count": 0 } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ], "result": { "invoices": [ { "amount_due": 0, "amount_paid": 0, "amount_remaining": 0, "currency": "currency", "id": "id", "attempt_count": 0, "attempted": true, "auto_advance": true, "created": 0, "created_by": "created_by", "description": "description", "invoice_origin": "invoice_origin", "invoice_pdf": "invoice_pdf", "status": "status" } ], "pagination": { "has_more": true, "page": 0, "per_page": 0, "total_count": 0 } }, "success": true, "result_info": { "has_more": true, "page": 0, "per_page": 0, "total_count": 0 } } ```