--- title: Get invoice history --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [AI Gateway](https://developers.cloudflare.com/api/go/resources/ai_gateway) [Billing](https://developers.cloudflare.com/api/go/resources/ai_gateway/subresources/billing) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get invoice history client.AIGateway.Billing.InvoiceHistory(ctx, params) (\*[BillingInvoiceHistoryResponse](), error) 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
params BillingInvoiceHistoryParams AccountID param.Field\[string] Path param: Cloudflare account ID. Link to this property
Type param.Field\[BillingInvoiceHistoryParamsType]Optional Query param: Filter invoice type: auto, manual, or all. const BillingInvoiceHistoryParamsTypeAuto BillingInvoiceHistoryParamsType = "auto" Link to this property const BillingInvoiceHistoryParamsTypeAll BillingInvoiceHistoryParamsType = "all" Link to this property const BillingInvoiceHistoryParamsTypeManual BillingInvoiceHistoryParamsType = "manual" Link to this property
Link to this property
[Link to this property](<#(resource)%20ai_gateway.billing%20%3E%20(method)%20invoice_history%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type BillingInvoiceHistoryResponse struct{…}
Invoices \[]BillingInvoiceHistoryResponseInvoice AmountDue float64 Link to this property AmountPaid float64 Link to this property AmountRemaining float64 Link to this property Currency string Link to this property ID stringOptional Link to this property AttemptCount float64Optional Link to this property Attempted boolOptional Link to this property AutoAdvance boolOptional Link to this property Created float64Optional Link to this property CreatedBy stringOptional Link to this property Description stringOptional Link to this property InvoiceOrigin stringOptional Link to this property InvoicePDF stringOptional Link to this property Status stringOptional Link to this property
Link to this property
Pagination BillingInvoiceHistoryResponsePagination HasMore bool Link to this property Page float64 Link to this property PerPage float64 Link to this property TotalCount float64 Link to this property
Link to this property
[Link to this property](<#(resource)%20ai_gateway.billing%20%3E%20(model)%20BillingInvoiceHistoryResponse%20%3E%20(schema)>) ### Get invoice history Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/ai_gateway" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) response, err := client.AIGateway.Billing.InvoiceHistory(context.TODO(), ai_gateway.BillingInvoiceHistoryParams{ AccountID: cloudflare.F("account_id"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", 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 } } ```