--- title: Get usage 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 usage history client.AIGateway.Billing.UsageHistory(ctx, params) (\*[BillingUsageHistoryResponse](), error) GET/accounts/{account\_id}/ai-gateway/billing/usage-history Retrieve aggregated usage meter event summaries for the given time range. ##### 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 BillingUsageHistoryParams AccountID param.Field\[string] Path param: Cloudflare account ID. Link to this property
ValueGroupingWindow param.Field\[BillingUsageHistoryParamsValueGroupingWindow] Query param: Grouping window for usage data. const BillingUsageHistoryParamsValueGroupingWindowDay BillingUsageHistoryParamsValueGroupingWindow = "day" Link to this property const BillingUsageHistoryParamsValueGroupingWindowHour BillingUsageHistoryParamsValueGroupingWindow = "hour" Link to this property
Link to this property EndTime param.Field\[float64]Optional Query param: End time as Unix timestamp in milliseconds. Link to this property StartTime param.Field\[float64]Optional Query param: Start time as Unix timestamp in milliseconds. Link to this property
[Link to this property](<#(resource)%20ai_gateway.billing%20%3E%20(method)%20usage_history%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type BillingUsageHistoryResponse struct{…}
History \[]BillingUsageHistoryResponseHistory ID string Link to this property AggregatedValue float64 Link to this property EndTime float64 Link to this property StartTime float64 Link to this property
Link to this property
[Link to this property](<#(resource)%20ai_gateway.billing%20%3E%20(model)%20BillingUsageHistoryResponse%20%3E%20(schema)>) ### Get usage 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.UsageHistory(context.TODO(), ai_gateway.BillingUsageHistoryParams{ AccountID: cloudflare.F("account_id"), ValueGroupingWindow: cloudflare.F(ai_gateway.BillingUsageHistoryParamsValueGroupingWindowDay), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.History) } ``` 200 example ``` { "errors": [ { "code": 0, "message": "message" } ], "messages": [ { "code": 0, "message": "message" } ], "result": { "history": [ { "id": "id", "aggregated_value": 0, "end_time": 0, "start_time": 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": { "history": [ { "id": "id", "aggregated_value": 0, "end_time": 0, "start_time": 0 } ] }, "success": true, "result_info": { "has_more": true, "page": 0, "per_page": 0, "total_count": 0 } } ```