--- title: List Gateway Logs --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [AI Gateway](https://developers.cloudflare.com/api/go/resources/ai_gateway) [Logs](https://developers.cloudflare.com/api/go/resources/ai_gateway/subresources/logs) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Gateway Logs client.AIGateway.Logs.List(ctx, gatewayID, params) (\*V4PagePaginationArray\[[LogListResponse]()], error) GET/accounts/{account\_id}/ai-gateway/gateways/{gateway\_id}/logs Lists request/response log entries for the AI gateway with filtering and pagination. ##### 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 gatewayID string Unique identifier of the AI Gateway within the account. maxLength64 minLength1 [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20gateway_id%20%3E%20(schema)>)
params LogListParams AccountID param.Field\[string] Path param Link to this property DeprecatedCached param.Field\[bool]Optional Query param Link to this property
DeprecatedDirection param.Field\[LogListParamsDirection]Optional Query param const LogListParamsDirectionAsc LogListParamsDirection = "asc" Link to this property const LogListParamsDirectionDesc LogListParamsDirection = "desc" Link to this property
Link to this property DeprecatedEndDate param.Field\[Time]Optional Query param formatdate-time Link to this property
DeprecatedFeedback param.Field\[LogListParamsFeedback]Optional Query param const LogListParamsFeedback0 LogListParamsFeedback = 0 Link to this property const LogListParamsFeedback1 LogListParamsFeedback = 1 Link to this property
Link to this property
Filters param.Field\[\[]LogListParamsFilter]Optional Query param
Key LogListParamsFiltersKey One of the following: const LogListParamsFiltersKeyID LogListParamsFiltersKey = "id" Link to this property const LogListParamsFiltersKeyCreatedAt LogListParamsFiltersKey = "created\_at" Link to this property const LogListParamsFiltersKeyRequestContentType LogListParamsFiltersKey = "request\_content\_type" Link to this property const LogListParamsFiltersKeyResponseContentType LogListParamsFiltersKey = "response\_content\_type" Link to this property const LogListParamsFiltersKeyRequestType LogListParamsFiltersKey = "request\_type" Link to this property const LogListParamsFiltersKeySuccess LogListParamsFiltersKey = "success" Link to this property const LogListParamsFiltersKeyCached LogListParamsFiltersKey = "cached" Link to this property const LogListParamsFiltersKeyProvider LogListParamsFiltersKey = "provider" Link to this property const LogListParamsFiltersKeyModel LogListParamsFiltersKey = "model" Link to this property const LogListParamsFiltersKeyModelType LogListParamsFiltersKey = "model\_type" Link to this property const LogListParamsFiltersKeyCost LogListParamsFiltersKey = "cost" Link to this property const LogListParamsFiltersKeyTokens LogListParamsFiltersKey = "tokens" Link to this property const LogListParamsFiltersKeyTokensIn LogListParamsFiltersKey = "tokens\_in" Link to this property const LogListParamsFiltersKeyTokensOut LogListParamsFiltersKey = "tokens\_out" Link to this property const LogListParamsFiltersKeyDuration LogListParamsFiltersKey = "duration" Link to this property const LogListParamsFiltersKeyFeedback LogListParamsFiltersKey = "feedback" Link to this property const LogListParamsFiltersKeyEventID LogListParamsFiltersKey = "event\_id" Link to this property const LogListParamsFiltersKeyMetadataKey LogListParamsFiltersKey = "metadata.key" Link to this property const LogListParamsFiltersKeyMetadataValue LogListParamsFiltersKey = "metadata.value" Link to this property const LogListParamsFiltersKeyAuthentication LogListParamsFiltersKey = "authentication" Link to this property const LogListParamsFiltersKeyWholesale LogListParamsFiltersKey = "wholesale" Link to this property const LogListParamsFiltersKeyCompatibilityMode LogListParamsFiltersKey = "compatibilityMode" Link to this property const LogListParamsFiltersKeyDLPAction LogListParamsFiltersKey = "dlp\_action" Link to this property const LogListParamsFiltersKeyUserAgent LogListParamsFiltersKey = "user\_agent" Link to this property
Link to this property
Operator LogListParamsFiltersOperator One of the following: const LogListParamsFiltersOperatorEq LogListParamsFiltersOperator = "eq" Link to this property const LogListParamsFiltersOperatorNeq LogListParamsFiltersOperator = "neq" Link to this property const LogListParamsFiltersOperatorContains LogListParamsFiltersOperator = "contains" Link to this property const LogListParamsFiltersOperatorLt LogListParamsFiltersOperator = "lt" Link to this property const LogListParamsFiltersOperatorGt LogListParamsFiltersOperator = "gt" Link to this property
Link to this property
Value \[]LogListParamsFiltersValueUnion Filter values. One of the following: UnionString Link to this property UnionFloat Link to this property UnionBool Link to this property
Link to this property
Link to this property DeprecatedMaxCost param.Field\[float64]Optional Query param Link to this property DeprecatedMaxDuration param.Field\[float64]Optional Query param Link to this property DeprecatedMaxTokensIn param.Field\[float64]Optional Query param Link to this property DeprecatedMaxTokensOut param.Field\[float64]Optional Query param Link to this property DeprecatedMaxTotalTokens param.Field\[float64]Optional Query param Link to this property MetaInfo param.Field\[bool]Optional Query param Link to this property DeprecatedMinCost param.Field\[float64]Optional Query param Link to this property DeprecatedMinDuration param.Field\[float64]Optional Query param Link to this property DeprecatedMinTokensIn param.Field\[float64]Optional Query param Link to this property DeprecatedMinTokensOut param.Field\[float64]Optional Query param Link to this property DeprecatedMinTotalTokens param.Field\[float64]Optional Query param Link to this property DeprecatedModel param.Field\[string]Optional Query param: Model filter. Link to this property DeprecatedModelType param.Field\[string]Optional Query param Link to this property
OrderBy param.Field\[LogListParamsOrderBy]Optional Query param const LogListParamsOrderByCreatedAt LogListParamsOrderBy = "created\_at" Link to this property const LogListParamsOrderByProvider LogListParamsOrderBy = "provider" Link to this property const LogListParamsOrderByModel LogListParamsOrderBy = "model" Link to this property const LogListParamsOrderByModelType LogListParamsOrderBy = "model\_type" Link to this property const LogListParamsOrderBySuccess LogListParamsOrderBy = "success" Link to this property const LogListParamsOrderByCached LogListParamsOrderBy = "cached" Link to this property
Link to this property
OrderByDirection param.Field\[LogListParamsOrderByDirection]Optional Query param const LogListParamsOrderByDirectionAsc LogListParamsOrderByDirection = "asc" Link to this property const LogListParamsOrderByDirectionDesc LogListParamsOrderByDirection = "desc" Link to this property
Link to this property Page param.Field\[int64]Optional Query param minimum1 Link to this property PerPage param.Field\[int64]Optional Query param maximum50 minimum1 Link to this property DeprecatedProvider param.Field\[string]Optional Query param Link to this property DeprecatedRequestContentType param.Field\[string]Optional Query param Link to this property DeprecatedResponseContentType param.Field\[string]Optional Query param Link to this property Search param.Field\[string]Optional Query param: Free-text search over log metadata. Link to this property DeprecatedStartDate param.Field\[Time]Optional Query param formatdate-time Link to this property DeprecatedSuccess param.Field\[bool]Optional Query param Link to this property
[Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type LogListResponse struct{…} ID string Link to this property Cached bool Link to this property CreatedAt Time formatdate-time Link to this property Duration int64 Link to this property Model string Link to this property Path string Link to this property Provider string Link to this property Success bool Link to this property TokensIn int64 Link to this property TokensOut int64 Link to this property Cost float64Optional Link to this property CustomCost boolOptional Link to this property Metadata stringOptional Link to this property ModelType stringOptional Link to this property RequestContentType stringOptional Link to this property RequestType stringOptional Link to this property ResponseContentType stringOptional Link to this property StatusCode int64Optional Link to this property Step int64Optional Link to this property
[Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(model)%20LogListResponse%20%3E%20(schema)>) ### List Gateway Logs 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"), ) page, err := client.AIGateway.Logs.List( context.TODO(), "my-gateway", ai_gateway.LogListParams{ AccountID: cloudflare.F("0d37909e38d3e99c29fa2cd343ac421a"), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 200 example ``` { "result": [ { "id": "id", "cached": true, "created_at": "2019-12-27T18:11:19.117Z", "duration": 0, "model": "model", "path": "path", "provider": "provider", "success": true, "tokens_in": 0, "tokens_out": 0, "cost": 0, "custom_cost": true, "metadata": "metadata", "model_type": "model_type", "request_content_type": "request_content_type", "request_type": "request_type", "response_content_type": "response_content_type", "status_code": 0, "step": 0 } ], "result_info": { "count": 0, "max_cost": 0, "max_duration": 0, "max_tokens_in": 0, "max_tokens_out": 0, "max_total_tokens": 0, "min_cost": 0, "min_duration": 0, "min_tokens_in": 0, "min_tokens_out": 0, "min_total_tokens": 0, "page": 0, "per_page": 0, "total_count": 0 }, "success": true } ``` ##### Returns Examples 200 example ``` { "result": [ { "id": "id", "cached": true, "created_at": "2019-12-27T18:11:19.117Z", "duration": 0, "model": "model", "path": "path", "provider": "provider", "success": true, "tokens_in": 0, "tokens_out": 0, "cost": 0, "custom_cost": true, "metadata": "metadata", "model_type": "model_type", "request_content_type": "request_content_type", "request_type": "request_type", "response_content_type": "response_content_type", "status_code": 0, "step": 0 } ], "result_info": { "count": 0, "max_cost": 0, "max_duration": 0, "max_tokens_in": 0, "max_tokens_out": 0, "max_total_tokens": 0, "min_cost": 0, "min_duration": 0, "min_tokens_in": 0, "min_tokens_out": 0, "min_total_tokens": 0, "page": 0, "per_page": 0, "total_count": 0 }, "success": true } ```