--- title: List web and API operations --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [API Gateway](https://developers.cloudflare.com/api/python/resources/api_gateway) [Operations](https://developers.cloudflare.com/api/python/resources/api_gateway/subresources/operations) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List web and API operations api\_gateway.operations.list(OperationListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[OperationListResponse]()] GET/zones/{zone\_id}/api\_gateway/operations Lists web and API operations tracked for the zone, including each operation’s method, path, and feature configuration. ##### 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) `Account API Gateway``Account API Gateway Read``Domain API Gateway``Domain API Gateway Read` ##### ParametersExpand Collapse zone\_id: str Identifier. maxLength32 [Link to this property](<#(resource)%20api_gateway.operations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20zone_id%20%3E%20(schema)>)
direction: Optional\[Literal\["asc", "desc"]] Direction to order results. One of the following: "asc" Link to this property "desc" Link to this property
[Link to this property](<#(resource)%20api_gateway.operations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20direction%20%3E%20(schema)>) endpoint: Optional\[str] Filter results to only include endpoints containing this pattern. [Link to this property](<#(resource)%20api_gateway.operations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20endpoint%20%3E%20(schema)>)
feature: Optional\[List\[Literal\["thresholds", "parameter\_schemas", "schema\_info", "confidence\_intervals"]]] Add feature(s) to the results. The feature name that is given here corresponds to the resulting feature object. Have a look at the top-level object description for more details on the specific meaning. One of the following: "thresholds" Link to this property "parameter\_schemas" Link to this property "schema\_info" Link to this property "confidence\_intervals" Link to this property
[Link to this property](<#(resource)%20api_gateway.operations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20feature%20%3E%20(schema)>) host: Optional\[Sequence\[str]] Filter results to only include the specified hosts. [Link to this property](<#(resource)%20api_gateway.operations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20host%20%3E%20(schema)>) method: Optional\[Sequence\[str]] Filter results to only include the specified HTTP methods. [Link to this property](<#(resource)%20api_gateway.operations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20method%20%3E%20(schema)>)
order: Optional\[Literal\["method", "host", "endpoint", "thresholds.$key"]] Field to order by. When requesting a feature, the feature keys are available for ordering as well, e.g., thresholds.suggested_threshold. One of the following: "method" Link to this property "host" Link to this property "endpoint" Link to this property "thresholds.$key" Link to this property
[Link to this property](<#(resource)%20api_gateway.operations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20order%20%3E%20(schema)>) page: Optional\[int] Page number of paginated results. minimum1 [Link to this property](<#(resource)%20api_gateway.operations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: Optional\[int] Maximum number of results per page. maximum50 minimum5 [Link to this property](<#(resource)%20api_gateway.operations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class OperationListResponse: … endpoint: str The endpoint which can contain path parameter templates in curly braces, each will be replaced from left to right with {varN}, starting with {var1}, during insertion. This will further be Cloudflare-normalized upon insertion. See: https://developers.cloudflare.com/rules/normalization/how-it-works/. formaturi-template maxLength4096 Link to this property host: str RFC3986-compliant host. formathostname maxLength255 Link to this property last\_updated: datetime formatdate-time Link to this property
method: Literal\["GET", "POST", "HEAD", 6 more] The HTTP method used to access the endpoint. One of the following: "GET" Link to this property "POST" Link to this property "HEAD" Link to this property "OPTIONS" Link to this property "PUT" Link to this property "DELETE" Link to this property "CONNECT" Link to this property "PATCH" Link to this property "TRACE" Link to this property
Link to this property operation\_id: str UUID. maxLength36 minLength36 Link to this property
features: Optional\[Features] One of the following:
class FeaturesAPIShieldOperationFeatureThresholds: …
thresholds: Optional\[FeaturesAPIShieldOperationFeatureThresholdsThresholds] auth\_id\_tokens: Optional\[int] The total number of auth-ids seen across this calculation. Link to this property data\_points: Optional\[int] The number of data points used for the threshold suggestion calculation. Link to this property last\_updated: Optional\[datetime] formatdate-time Link to this property p50: Optional\[int] The p50 quantile of requests (in period\_seconds). Link to this property p90: Optional\[int] The p90 quantile of requests (in period\_seconds). Link to this property p99: Optional\[int] The p99 quantile of requests (in period\_seconds). Link to this property period\_seconds: Optional\[int] The period over which this threshold is suggested. Link to this property requests: Optional\[int] The estimated number of requests covered by these calculations. Link to this property suggested\_threshold: Optional\[int] The suggested threshold in requests done by the same auth\_id or period\_seconds. Link to this property
Link to this property
Link to this property
class FeaturesAPIShieldOperationFeatureParameterSchemas: …
parameter\_schemas: FeaturesAPIShieldOperationFeatureParameterSchemasParameterSchemas last\_updated: Optional\[datetime] formatdate-time Link to this property
parameter\_schemas: Optional\[FeaturesAPIShieldOperationFeatureParameterSchemasParameterSchemasParameterSchemas] An operation schema object containing a response. parameters: Optional\[List\[object]] An array containing the learned parameter schemas. Link to this property responses: Optional\[object] An empty response object. This field is required to yield a valid operation schema. Link to this property
Link to this property
Link to this property
Link to this property
class FeaturesAPIShieldOperationFeatureAPIRouting: …
api\_routing: Optional\[FeaturesAPIShieldOperationFeatureAPIRoutingAPIRouting] API Routing settings on endpoint. last\_updated: Optional\[datetime] formatdate-time Link to this property route: Optional\[str] Target route. Link to this property
Link to this property
Link to this property
class FeaturesAPIShieldOperationFeatureConfidenceIntervals: …
confidence\_intervals: Optional\[FeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervals] last\_updated: Optional\[datetime] formatdate-time Link to this property
suggested\_threshold: Optional\[FeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThreshold]
confidence\_intervals: Optional\[FeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThresholdConfidenceIntervals]
p90: Optional\[FeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThresholdConfidenceIntervalsP90] Upper and lower bound for percentile estimate lower: Optional\[float] Lower bound for percentile estimate Link to this property upper: Optional\[float] Upper bound for percentile estimate Link to this property
Link to this property
p95: Optional\[FeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThresholdConfidenceIntervalsP95] Upper and lower bound for percentile estimate lower: Optional\[float] Lower bound for percentile estimate Link to this property upper: Optional\[float] Upper bound for percentile estimate Link to this property
Link to this property
p99: Optional\[FeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThresholdConfidenceIntervalsP99] Upper and lower bound for percentile estimate lower: Optional\[float] Lower bound for percentile estimate Link to this property upper: Optional\[float] Upper bound for percentile estimate Link to this property
Link to this property
Link to this property mean: Optional\[float] Suggested threshold. Link to this property
Link to this property
Link to this property
Link to this property
class FeaturesAPIShieldOperationFeatureSchemaInfo: …
schema\_info: Optional\[FeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfo]
active\_schema: Optional\[FeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoActiveSchema] Schema active on endpoint. id: Optional\[str] UUID. maxLength36 minLength36 Link to this property created\_at: Optional\[datetime] formatdate-time Link to this property name: Optional\[str] Schema file name. Link to this property
Link to this property
mitigation\_action: Optional\[Literal\["none", "log", "block"]] Action taken on requests failing validation. One of the following: "none" Link to this property "log" Link to this property "block" Link to this property
Link to this property
Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20api_gateway.operations%20%3E%20(model)%20operation_list_response%20%3E%20(schema)>) ### List web and API operations 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.api_gateway.operations.list( zone_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result[0] print(page.operation_id) ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "endpoint": "/api/v1/users/{var1}", "host": "www.example.com", "last_updated": "2014-01-01T05:20:00.12345Z", "method": "GET", "operation_id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "features": { "api_routing": { "last_updated": "2014-01-01T05:20:00.12345Z", "route": "https://api.example.com/api/service" } } } ], "success": true, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "endpoint": "/api/v1/users/{var1}", "host": "www.example.com", "last_updated": "2014-01-01T05:20:00.12345Z", "method": "GET", "operation_id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "features": { "api_routing": { "last_updated": "2014-01-01T05:20:00.12345Z", "route": "https://api.example.com/api/service" } } } ], "success": true, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ```