Skip to content
Cloudflare API
Start here
API Reference
AI Gateway
Logs

List Gateway Logs

GET/accounts/{account_id}/ai-gateway/gateways/{gateway_id}/logs

List Gateway Logs

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 WriteAI Gateway Read
Path ParametersExpand Collapse
account_id: string
gateway_id: string

gateway id

maxLength64
minLength1
Query ParametersExpand Collapse
Deprecatedcached: optional boolean
Deprecateddirection: optional "asc" or "desc"
One of the following:
"asc"
"desc"
Deprecatedend_date: optional string
formatdate-time
Deprecatedfeedback: optional 0 or 1
One of the following:
0
1
filters: optional array of object { key, operator, value }
key: "id" or "created_at" or "request_content_type" or 20 more
One of the following:
"id"
"created_at"
"request_content_type"
"response_content_type"
"request_type"
"success"
"cached"
"provider"
"model"
"model_type"
"cost"
"tokens"
"tokens_in"
"tokens_out"
"duration"
"feedback"
"event_id"
"metadata.key"
"metadata.value"
"authentication"
"wholesale"
"compatibilityMode"
"dlp_action"
operator: "eq" or "neq" or "contains" or 2 more
One of the following:
"eq"
"neq"
"contains"
"lt"
"gt"
value: array of string or number or boolean
One of the following:
string
number
boolean
Deprecatedmax_cost: optional number
Deprecatedmax_duration: optional number
Deprecatedmax_tokens_in: optional number
Deprecatedmax_tokens_out: optional number
Deprecatedmax_total_tokens: optional number
meta_info: optional boolean
Deprecatedmin_cost: optional number
Deprecatedmin_duration: optional number
Deprecatedmin_tokens_in: optional number
Deprecatedmin_tokens_out: optional number
Deprecatedmin_total_tokens: optional number
Deprecatedmodel: optional string
Deprecatedmodel_type: optional string
order_by: optional "created_at" or "provider" or "model" or 3 more
One of the following:
"created_at"
"provider"
"model"
"model_type"
"success"
"cached"
order_by_direction: optional "asc" or "desc"
One of the following:
"asc"
"desc"
page: optional number
minimum1
per_page: optional number
maximum50
minimum1
Deprecatedprovider: optional string
Deprecatedrequest_content_type: optional string
Deprecatedresponse_content_type: optional string
Deprecatedstart_date: optional string
formatdate-time
Deprecatedsuccess: optional boolean
ReturnsExpand Collapse
result: array of object { id, cached, created_at, 16 more }
id: string
cached: boolean
created_at: string
formatdate-time
duration: number
model: string
path: string
provider: string
success: boolean
tokens_in: number
tokens_out: number
cost: optional number
custom_cost: optional boolean
metadata: optional string
model_type: optional string
request_content_type: optional string
request_type: optional string
response_content_type: optional string
status_code: optional number
step: optional number
result_info: object { count, max_cost, max_duration, 11 more }
count: optional number
max_cost: optional number
max_duration: optional number
max_tokens_in: optional number
max_tokens_out: optional number
max_total_tokens: optional number
min_cost: optional number
min_duration: optional number
min_tokens_in: optional number
min_tokens_out: optional number
min_total_tokens: optional number
page: optional number
per_page: optional number
total_count: optional number
success: boolean

List Gateway Logs

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/ai-gateway/gateways/$GATEWAY_ID/logs \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
{
  "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
{
  "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
}