--- title: List gateways --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [AI Gateway](https://developers.cloudflare.com/api/resources/ai_gateway) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List gateways GET/accounts/{account\_id}/ai-gateway/gateways Lists the AI Gateways in the account. Use `search` to filter by gateway ID. ##### 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%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) ##### Q uery ParametersExpand Collapse page: optional number minimum1 [Link to this property](<#(resource)%20ai_gateway%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: optional number maximum100 minimum1 [Link to this property](<#(resource)%20ai_gateway%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) search: optional string Search by id [Link to this property](<#(resource)%20ai_gateway%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20search%20%3E%20(schema)>) ##### ReturnsExpand Collapse

result: array of object {id, cache\_invalidate\_on\_update, cache\_ttl, 25 more }

id: string Unique identifier of the AI Gateway within the account. maxLength64 minLength1 Link to this property cache\_invalidate\_on\_update: boolean Link to this property cache\_ttl: number minimum0 Link to this property collect\_logs: boolean Link to this property created\_at: string formatdate-time Link to this property modified\_at: string formatdate-time Link to this property rate\_limiting\_interval: number minimum0 Link to this property rate\_limiting\_limit: number minimum0 Link to this property authentication: optional boolean Link to this property byok\_only: optional boolean Requires customer-provided provider credentials and prevents fallback to Unified Billing. Link to this property

dlp: optional object {action, enabled, profiles } or object {enabled, policies }

One of the following:

object {action, enabled, profiles }

action: "BLOCK"or "FLAG"

One of the following: "BLOCK" Link to this property "FLAG" Link to this property

Link to this property enabled: boolean Link to this property profiles: array of string Link to this property

Link to this property

object {enabled, policies }

enabled: boolean Link to this property

policies: array of object {id, action, check, 2 more }

id: string Link to this property

action: "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

check: array of "REQUEST"or "RESPONSE"

One of the following: "REQUEST" Link to this property "RESPONSE" Link to this property

Link to this property enabled: boolean Link to this property profiles: array of string Link to this property

Link to this property

guardrails: optional object {prompt, response }

prompt: object {P1, S1, S10, 11 more }

P1: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S1: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S10: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S11: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S12: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S13: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S2: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S3: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S4: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S5: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S6: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S7: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S8: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S9: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

response: object {P1, S1, S10, 11 more }

P1: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S1: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S10: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S11: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S12: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S13: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S2: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S3: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S4: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S5: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S6: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S7: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S8: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

S9: optional "FLAG"or "BLOCK"

One of the following: "FLAG" Link to this property "BLOCK" Link to this property

Link to this property

Link to this property is\_default: optional boolean Link to this property log\_classification: optional boolean Link to this property log\_management: optional number maximum10000000 minimum10000 Link to this property

log\_management\_strategy: optional "STOP\_INSERTING"or "DELETE\_OLDEST"

One of the following: "STOP\_INSERTING" Link to this property "DELETE\_OLDEST" Link to this property

Link to this property logpush: optional boolean Link to this property logpush\_public\_key: optional string maxLength1024 minLength16 Link to this property

otel: optional array of object {headers, url, authorization, content\_type }

headers: map\[string] Link to this property url: string formaturi maxLength2048 Link to this property authorization: optional string maxLength256 Link to this property

content\_type: optional "json"or "protobuf"

One of the following: "json" Link to this property "protobuf" Link to this property

Link to this property

rate\_limiting\_technique: optional "fixed"or "sliding"

One of the following: "fixed" Link to this property "sliding" Link to this property

Link to this property

retry\_backoff: optional "constant"or "linear"or "exponential" Backoff strategy for retry delays

One of the following: "constant" Link to this property "linear" Link to this property "exponential" Link to this property

Link to this property retry\_delay: optional number Delay between retry attempts in milliseconds (0-60000) maximum60000 minimum0 Link to this property retry\_max\_attempts: optional number Maximum number of retry attempts for failed requests (1-5) maximum5 minimum1 Link to this property

spend\_limits: optional object {enabled, rules }

enabled: optional boolean Link to this property

rules: optional array of object {limit, limitType, window, 6 more }

limit: number exclusiveMinimum minimum0 Link to this property limitType: "cost" Link to this property window: number exclusiveMinimum minimum0 Link to this property id: optional string minLength1 Link to this property enabled: optional boolean Link to this property

metadata: optional map\[object {mode } or object {mode, values } ]

One of the following:

Mode object {mode }

mode: "partition" Link to this property

Link to this property

object {mode, values }

mode: "filter" Link to this property values: array of string Link to this property

Link to this property

model: optional object {mode, values }

mode: "filter" Link to this property values: array of string Link to this property

Link to this property

provider: optional object {mode, values }

mode: "filter" Link to this property values: array of string Link to this property

Link to this property

technique: optional "fixed"or "sliding"

One of the following: "fixed" Link to this property "sliding" Link to this property

Link to this property

Link to this property store\_id: optional string Link to this property

stripe: optional object {authorization, usage\_events }

authorization: string Link to this property

usage\_events: array of object {payload }

payload: string Link to this property

Link to this property

workers\_ai\_billing\_mode: optional "postpaid"or "unified" Controls how Workers AI inference calls routed through this gateway are billed. ‘postpaid’ bills the account directly through Workers AI; ‘unified’ deducts credits via AI Gateway using neuron-based pricing and delegates billing to AI Gateway.

One of the following: "postpaid" Link to this property "unified" Link to this property

Link to this property zdr: optional boolean Link to this property

[Link to this property](<#(resource)%20ai_gateway%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: boolean [Link to this property](<#(resource)%20ai_gateway%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>) ### List gateways HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/ai-gateway/gateways \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 200 example ``` { "result": [ { "id": "my-gateway", "cache_invalidate_on_update": true, "cache_ttl": 0, "collect_logs": true, "created_at": "2019-12-27T18:11:19.117Z", "modified_at": "2019-12-27T18:11:19.117Z", "rate_limiting_interval": 0, "rate_limiting_limit": 0, "authentication": true, "byok_only": true, "dlp": { "action": "BLOCK", "enabled": true, "profiles": [ "string" ] }, "guardrails": { "prompt": { "P1": "FLAG", "S1": "FLAG", "S10": "FLAG", "S11": "FLAG", "S12": "FLAG", "S13": "FLAG", "S2": "FLAG", "S3": "FLAG", "S4": "FLAG", "S5": "FLAG", "S6": "FLAG", "S7": "FLAG", "S8": "FLAG", "S9": "FLAG" }, "response": { "P1": "FLAG", "S1": "FLAG", "S10": "FLAG", "S11": "FLAG", "S12": "FLAG", "S13": "FLAG", "S2": "FLAG", "S3": "FLAG", "S4": "FLAG", "S5": "FLAG", "S6": "FLAG", "S7": "FLAG", "S8": "FLAG", "S9": "FLAG" } }, "is_default": true, "log_classification": true, "log_management": 10000, "log_management_strategy": "STOP_INSERTING", "logpush": true, "logpush_public_key": "xxxxxxxxxxxxxxxx", "otel": [ { "headers": { "foo": "string" }, "url": "https://example.com", "authorization": "authorization", "content_type": "json" } ], "rate_limiting_technique": "fixed", "retry_backoff": "constant", "retry_delay": 0, "retry_max_attempts": 1, "spend_limits": { "enabled": true, "rules": [ { "limit": 1, "limitType": "cost", "window": 1, "id": "x", "enabled": true, "metadata": { "foo": { "mode": "partition" } }, "model": { "mode": "filter", "values": [ "string" ] }, "provider": { "mode": "filter", "values": [ "string" ] }, "technique": "fixed" } ] }, "store_id": "store_id", "stripe": { "authorization": "authorization", "usage_events": [ { "payload": "payload" } ] }, "workers_ai_billing_mode": "postpaid", "zdr": true } ], "success": true } ``` ##### Returns Examples 200 example ``` { "result": [ { "id": "my-gateway", "cache_invalidate_on_update": true, "cache_ttl": 0, "collect_logs": true, "created_at": "2019-12-27T18:11:19.117Z", "modified_at": "2019-12-27T18:11:19.117Z", "rate_limiting_interval": 0, "rate_limiting_limit": 0, "authentication": true, "byok_only": true, "dlp": { "action": "BLOCK", "enabled": true, "profiles": [ "string" ] }, "guardrails": { "prompt": { "P1": "FLAG", "S1": "FLAG", "S10": "FLAG", "S11": "FLAG", "S12": "FLAG", "S13": "FLAG", "S2": "FLAG", "S3": "FLAG", "S4": "FLAG", "S5": "FLAG", "S6": "FLAG", "S7": "FLAG", "S8": "FLAG", "S9": "FLAG" }, "response": { "P1": "FLAG", "S1": "FLAG", "S10": "FLAG", "S11": "FLAG", "S12": "FLAG", "S13": "FLAG", "S2": "FLAG", "S3": "FLAG", "S4": "FLAG", "S5": "FLAG", "S6": "FLAG", "S7": "FLAG", "S8": "FLAG", "S9": "FLAG" } }, "is_default": true, "log_classification": true, "log_management": 10000, "log_management_strategy": "STOP_INSERTING", "logpush": true, "logpush_public_key": "xxxxxxxxxxxxxxxx", "otel": [ { "headers": { "foo": "string" }, "url": "https://example.com", "authorization": "authorization", "content_type": "json" } ], "rate_limiting_technique": "fixed", "retry_backoff": "constant", "retry_delay": 0, "retry_max_attempts": 1, "spend_limits": { "enabled": true, "rules": [ { "limit": 1, "limitType": "cost", "window": 1, "id": "x", "enabled": true, "metadata": { "foo": { "mode": "partition" } }, "model": { "mode": "filter", "values": [ "string" ] }, "provider": { "mode": "filter", "values": [ "string" ] }, "technique": "fixed" } ] }, "store_id": "store_id", "stripe": { "authorization": "authorization", "usage_events": [ { "payload": "payload" } ] }, "workers_ai_billing_mode": "postpaid", "zdr": true } ], "success": true } ```