--- title: Request Trace --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Rules Trace](https://developers.cloudflare.com/api/python/resources/request_tracers) [Traces](https://developers.cloudflare.com/api/python/resources/request_tracers/subresources/traces) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Request Trace request\_tracers.traces.create(TraceCreateParams\*\*kwargs) -> [TraceCreateResponse]() POST/accounts/{account\_id}/request-tracer/trace Traces a simulated HTTP request through Cloudflare’s edge to analyze how rules, settings, and configurations would process the request. Useful for debugging firewall rules, page rules, and other request transformations without sending actual traffic. Supports custom headers, cookies, body content, and geolocation context. ##### 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) `Allow Request Tracer Read` ##### ParametersExpand Collapse account\_id: str Identifier. maxLength32 [Link to this property](<#(resource)%20request_tracers.traces%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) method: str HTTP Method of tracing request [Link to this property](<#(resource)%20request_tracers.traces%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20method%20%3E%20(schema)>) url: str URL to which perform tracing request [Link to this property](<#(resource)%20request_tracers.traces%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20url%20%3E%20(schema)>)
body: Optional\[Body] base64: Optional\[str] Base64 encoded request body Link to this property json: Optional\[object] Arbitrary json as request body Link to this property plain\_text: Optional\[str] Request body as plain text Link to this property
[Link to this property](<#(resource)%20request_tracers.traces%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20body%20%3E%20(schema)>)
context: Optional\[Context] Additional request parameters bot\_score: Optional\[int] Bot score used for evaluating tracing request processing Link to this property
geoloc: Optional\[ContextGeoloc] Geodata for tracing request city: Optional\[str] Link to this property continent: Optional\[str] Link to this property is\_eu\_country: Optional\[bool] Link to this property iso\_code: Optional\[str] Link to this property latitude: Optional\[float] Link to this property longitude: Optional\[float] Link to this property postal\_code: Optional\[str] Link to this property region\_code: Optional\[str] Link to this property subdivision\_2\_iso\_code: Optional\[str] Link to this property timezone: Optional\[str] Link to this property
Link to this property skip\_challenge: Optional\[bool] Whether to skip any challenges for tracing request (e.g.: captcha) Link to this property threat\_score: Optional\[int] Threat score used for evaluating tracing request processing Link to this property
[Link to this property](<#(resource)%20request_tracers.traces%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20context%20%3E%20(schema)>) cookies: Optional\[Dict\[str, str]] Cookies added to tracing request [Link to this property](<#(resource)%20request_tracers.traces%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20cookies%20%3E%20(schema)>) headers: Optional\[Dict\[str, str]] Headers added to tracing request [Link to this property](<#(resource)%20request_tracers.traces%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20headers%20%3E%20(schema)>) protocol: Optional\[str] HTTP Protocol of tracing request [Link to this property](<#(resource)%20request_tracers.traces%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20protocol%20%3E%20(schema)>) skip\_response: Optional\[[bool]()] Skip sending the request to the Origin server after all rules evaluation [Link to this property](<#(resource)%20request_tracers.traces%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20skip_response%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class TraceCreateResponse: … Trace result with an origin status code status\_code: Optional\[int] HTTP Status code of zone response Link to this property trace: Optional\[Trace] Link to this property
[Link to this property](<#(resource)%20request_tracers.traces%20%3E%20(model)%20trace_create_response%20%3E%20(schema)>) ### Request Trace 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 ) trace = client.request_tracers.traces.create( account_id="023e105f4ecef8ad9ca31a8372d0c353", method="PUT", url="https://some.zone/some_path", body={ "base64": "c29tZV9yZXF1ZXN0X2JvZHk=" }, context={ "geoloc": { "city": "London" }, "skip_challenge": True, }, cookies={ "cookie_name_1": "cookie_value_1", "cookie_name_2": "cookie_value_2", }, headers={ "header_name_1": "header_value_1", "header_name_2": "header_value_2", }, protocol="HTTP/1.1", ) print(trace.status_code) ``` 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" } } ], "success": true, "result": { "status_code": 0, "trace": [ { "action": "execute", "action_parameters": { "id": "4814384a9e5d4991b9815dcfc25d2f1f" }, "description": "some rule", "expression": "ip.src ne 1.1.1.1", "kind": "zone", "matched": true, "name": "some ruleset name", "step_name": "rule_id01", "type": "rule" } ] } } ``` ##### 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" } } ], "success": true, "result": { "status_code": 0, "trace": [ { "action": "execute", "action_parameters": { "id": "4814384a9e5d4991b9815dcfc25d2f1f" }, "description": "some rule", "expression": "ip.src ne 1.1.1.1", "kind": "zone", "matched": true, "name": "some ruleset name", "step_name": "rule_id01", "type": "rule" } ] } } ```