--- title: List Gateway Logs --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [AI Gateway](https://developers.cloudflare.com/api/python/resources/ai_gateway) [Logs](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/logs) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Gateway Logs ai\_gateway.logs.list(strgateway\_id, LogListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[LogListResponse]()] 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 account\_id: str [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) gateway\_id: str 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)>) Deprecatedcached: Optional\[[bool]()] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20cached%20%3E%20(schema)>)
Deprecateddirection: Optional\[Literal\["asc", "desc"]] One of the following: "asc" Link to this property "desc" Link to this property
[Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20direction%20%3E%20(schema)>) Deprecatedend\_date: Optional\[Union\[str, datetime]] formatdate-time [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20end_date%20%3E%20(schema)>)
Deprecatedfeedback: Optional\[Literal\[0, 1]] One of the following: 0 Link to this property 1 Link to this property
[Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20feedback%20%3E%20(schema)>)
filters: Optional\[Iterable\[Filter]]
key: Literal\["id", "created\_at", "request\_content\_type", 21 more] One of the following: "id" Link to this property "created\_at" Link to this property "request\_content\_type" Link to this property "response\_content\_type" Link to this property "request\_type" Link to this property "success" Link to this property "cached" Link to this property "provider" Link to this property "model" Link to this property "model\_type" Link to this property "cost" Link to this property "tokens" Link to this property "tokens\_in" Link to this property "tokens\_out" Link to this property "duration" Link to this property "feedback" Link to this property "event\_id" Link to this property "metadata.key" Link to this property "metadata.value" Link to this property "authentication" Link to this property "wholesale" Link to this property "compatibilityMode" Link to this property "dlp\_action" Link to this property "user\_agent" Link to this property
Link to this property
operator: Literal\["eq", "neq", "contains", 2 more] One of the following: "eq" Link to this property "neq" Link to this property "contains" Link to this property "lt" Link to this property "gt" Link to this property
Link to this property
value: Sequence\[Union\[Optional\[str], float, bool]] Filter values. One of the following: Optional\[str] Link to this property float Link to this property bool Link to this property
Link to this property
[Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20filters%20%3E%20(schema)>) Deprecatedmax\_cost: Optional\[float] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20max_cost%20%3E%20(schema)>) Deprecatedmax\_duration: Optional\[float] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20max_duration%20%3E%20(schema)>) Deprecatedmax\_tokens\_in: Optional\[float] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20max_tokens_in%20%3E%20(schema)>) Deprecatedmax\_tokens\_out: Optional\[float] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20max_tokens_out%20%3E%20(schema)>) Deprecatedmax\_total\_tokens: Optional\[float] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20max_total_tokens%20%3E%20(schema)>) meta\_info: Optional\[[bool]()] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20meta_info%20%3E%20(schema)>) Deprecatedmin\_cost: Optional\[float] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20min_cost%20%3E%20(schema)>) Deprecatedmin\_duration: Optional\[float] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20min_duration%20%3E%20(schema)>) Deprecatedmin\_tokens\_in: Optional\[float] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20min_tokens_in%20%3E%20(schema)>) Deprecatedmin\_tokens\_out: Optional\[float] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20min_tokens_out%20%3E%20(schema)>) Deprecatedmin\_total\_tokens: Optional\[float] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20min_total_tokens%20%3E%20(schema)>) Deprecatedmodel: Optional\[str] Model filter. [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20model%20%3E%20(schema)>) Deprecatedmodel\_type: Optional\[str] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20model_type%20%3E%20(schema)>)
order\_by: Optional\[Literal\["created\_at", "provider", "model", 3 more]] One of the following: "created\_at" Link to this property "provider" Link to this property "model" Link to this property "model\_type" Link to this property "success" Link to this property "cached" Link to this property
[Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20order_by%20%3E%20(schema)>)
order\_by\_direction: Optional\[Literal\["asc", "desc"]] One of the following: "asc" Link to this property "desc" Link to this property
[Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20order_by_direction%20%3E%20(schema)>) page: Optional\[int] minimum1 [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: Optional\[int] maximum50 minimum1 [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) Deprecatedprovider: Optional\[str] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20provider%20%3E%20(schema)>) Deprecatedrequest\_content\_type: Optional\[str] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20request_content_type%20%3E%20(schema)>) Deprecatedresponse\_content\_type: Optional\[str] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20response_content_type%20%3E%20(schema)>) search: Optional\[str] Free-text search over log metadata. [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20search%20%3E%20(schema)>) Deprecatedstart\_date: Optional\[Union\[str, datetime]] formatdate-time [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20start_date%20%3E%20(schema)>) Deprecatedsuccess: Optional\[[bool]()] [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20success%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class LogListResponse: … id: str Link to this property cached: bool Link to this property created\_at: datetime formatdate-time Link to this property duration: int Link to this property model: str Link to this property path: str Link to this property provider: str Link to this property success: bool Link to this property tokens\_in: Optional\[int] Link to this property tokens\_out: Optional\[int] Link to this property cost: Optional\[float] Link to this property custom\_cost: Optional\[bool] Link to this property metadata: Optional\[str] Link to this property model\_type: Optional\[str] Link to this property request\_content\_type: Optional\[str] Link to this property request\_type: Optional\[str] Link to this property response\_content\_type: Optional\[str] Link to this property status\_code: Optional\[int] Link to this property step: Optional\[int] Link to this property
[Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(model)%20log_list_response%20%3E%20(schema)>) ### List Gateway Logs 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 ) page = client.ai_gateway.logs.list( gateway_id="my-gateway", account_id="0d37909e38d3e99c29fa2cd343ac421a", ) page = page.result[0] print(page.id) ``` 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 } ```