--- title: List Gateway Logs --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [AI Gateway](https://developers.cloudflare.com/api/resources/ai_gateway) [Logs](https://developers.cloudflare.com/api/resources/ai_gateway/subresources/logs) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Gateway Logs 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` ##### P ath ParametersExpand Collapse account\_id: string [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: 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)>) ##### Q uery ParametersExpand Collapse Deprecatedcached: optional boolean [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 "asc"or "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 string 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 0or 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 array of object {key, operator, value }

key: "id"or "created\_at"or "request\_content\_type"or 21 more

Link to this property

operator: "eq"or "neq"or "contains"or 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: array of stringor numberor boolean Filter values.

One of the following: string Link to this property number Link to this property boolean 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 number [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 number [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 number [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 number [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 number [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 boolean [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 number [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 number [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 number [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 number [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 number [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 string 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 string [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 "created\_at"or "provider"or "model"or 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 "asc"or "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 number 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 number 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 string [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 string [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 string [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 string 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 string 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 boolean [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

result: array of object {id, cached, created\_at, 16 more }

id: string Link to this property cached: boolean Link to this property created\_at: string formatdate-time Link to this property duration: number Link to this property model: string Link to this property path: string Link to this property provider: string Link to this property success: boolean Link to this property tokens\_in: number Link to this property tokens\_out: number Link to this property cost: optional number Link to this property custom\_cost: optional boolean Link to this property metadata: optional string Link to this property model\_type: optional string Link to this property request\_content\_type: optional string Link to this property request\_type: optional string Link to this property response\_content\_type: optional string Link to this property status\_code: optional number Link to this property step: optional number Link to this property

[Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>)

result\_info: object {count, max\_cost, max\_duration, 11 more }

count: optional number Link to this property max\_cost: optional number Link to this property max\_duration: optional number Link to this property max\_tokens\_in: optional number Link to this property max\_tokens\_out: optional number Link to this property max\_total\_tokens: optional number Link to this property min\_cost: optional number Link to this property min\_duration: optional number Link to this property min\_tokens\_in: optional number Link to this property min\_tokens\_out: optional number Link to this property min\_total\_tokens: optional number Link to this property page: optional number Link to this property per\_page: optional number Link to this property total\_count: optional number Link to this property

[Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) success: boolean [Link to this property](<#(resource)%20ai_gateway.logs%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>) ### List Gateway Logs HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/ai-gateway/gateways/$GATEWAY_ID/logs \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 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 } ```