--- title: List Turnstile Widgets --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Turnstile](https://developers.cloudflare.com/api/resources/turnstile) [Widgets](https://developers.cloudflare.com/api/resources/turnstile/subresources/widgets) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Turnstile Widgets GET/accounts/{account\_id}/challenges/widgets Lists Turnstile widgets for an account. ##### 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) `Turnstile Sites Write``Turnstile Sites Read``Account Settings Write``Account Settings Read` ##### P ath ParametersExpand Collapse account\_id: string Identifier maxLength32 [Link to this property](<#(resource)%20turnstile.widgets%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) ##### Q uery ParametersExpand Collapse
direction: optional "asc"or "desc" Direction to order widgets. One of the following: "asc" Link to this property "desc" Link to this property
[Link to this property](<#(resource)%20turnstile.widgets%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20direction%20%3E%20(schema)>) filter: optional string Filter widgets by field. The `name` field uses case-insensitive substring matching; `sitekey` uses exact matching. Format: `field:value` Supported fields: - `name` - Filter by widget name (e.g., `filter=name:login-form`) - `sitekey` - Filter by sitekey (e.g., `filter=sitekey:0x4AAA`) Returns 400 Bad Request if the field is unsupported or format is invalid. An empty filter value returns all results. [Link to this property](<#(resource)%20turnstile.widgets%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20filter%20%3E%20(schema)>)
order: optional "id"or "sitekey"or "name"or 2 more Field to order widgets by. One of the following: "id" Link to this property "sitekey" Link to this property "name" Link to this property "created\_on" Link to this property "modified\_on" Link to this property
[Link to this property](<#(resource)%20turnstile.widgets%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20order%20%3E%20(schema)>) page: optional number Page number of paginated results. minimum1 [Link to this property](<#(resource)%20turnstile.widgets%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: optional number Number of items per page. maximum1000 minimum5 [Link to this property](<#(resource)%20turnstile.widgets%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) ##### ReturnsExpand Collapse
errors: array of ResponseInfo { code, message, documentation\_url, source } code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property
source: optional object {pointer } pointer: optional string Link to this property
Link to this property
[Link to this property](<#(resource)%20turnstile.widgets%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of ResponseInfo { code, message, documentation\_url, source } code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property
source: optional object {pointer } pointer: optional string Link to this property
Link to this property
[Link to this property](<#(resource)%20turnstile.widgets%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20messages>) success: boolean Whether the API call was successful [Link to this property](<#(resource)%20turnstile.widgets%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
result: optional array of object {bot\_fight\_mode, clearance\_level, created\_on, 10 more } bot\_fight\_mode: boolean If bot\_fight\_mode is set to true, Cloudflare issues computationally expensive challenges in response to malicious bots (ENT only). Link to this property
clearance\_level: "no\_clearance"or "jschallenge"or "managed"or "interactive" If Turnstile is embedded on a Cloudflare site and the widget should grant challenge clearance, this setting can determine the clearance level to be set One of the following: "no\_clearance" Link to this property "jschallenge" Link to this property "managed" Link to this property "interactive" Link to this property
Link to this property created\_on: string When the widget was created. formatdate-time Link to this property domains: array of WidgetDomain maxLength10 Link to this property ephemeral\_id: boolean Return the Ephemeral ID in /siteverify (ENT only). Link to this property
mode: "non-interactive"or "invisible"or "managed" Widget Mode One of the following: "non-interactive" Link to this property "invisible" Link to this property "managed" Link to this property
Link to this property modified\_on: string When the widget was modified. formatdate-time Link to this property name: string Human readable widget name. Not unique. Cloudflare suggests that you set this to a meaningful string to make it easier to identify your widget, and where it is used. maxLength254 minLength1 Link to this property offlabel: boolean Do not show any Cloudflare branding on the widget (ENT only). Link to this property
region: "world"or "china" Region where this widget can be used. This cannot be changed after creation. One of the following: "world" Link to this property "china" Link to this property
Link to this property sitekey: string Unique identifier for a Turnstile widget. maxLength32 Link to this property
deployed\_via: optional "wrangler"or "dashboard"or "spin"or 2 more Origin that created this widget, recorded at creation time and immutable afterward. Server-derived from the create request; not client-settable. Omitted from the response for widgets created before this field existed. One of the following: "wrangler" Link to this property "dashboard" Link to this property "spin" Link to this property "api" Link to this property "unknown" Link to this property
Link to this property
last\_modified\_via: optional "wrangler"or "dashboard"or "spin"or 2 more Origin of the most recent mutation (create, update, delete, or secret rotation). Server-derived; not client-settable. Omitted for widgets last mutated before this field existed. One of the following: "wrangler" Link to this property "dashboard" Link to this property "spin" Link to this property "api" Link to this property "unknown" Link to this property
Link to this property
[Link to this property](<#(resource)%20turnstile.widgets%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
result\_info: optional object {count, page, per\_page, total\_count } count: number Total number of results for the requested service Link to this property page: number Current page within paginated list of results Link to this property per\_page: number Number of results per page of results Link to this property total\_count: number Total results available without any search parameters Link to this property
[Link to this property](<#(resource)%20turnstile.widgets%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) ### List Turnstile Widgets HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/challenges/widgets \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 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": [ { "bot_fight_mode": false, "clearance_level": "interactive", "created_on": "2014-01-01T05:20:00.123123Z", "domains": [ "203.0.113.1", "cloudflare.com", "blog.example.com" ], "ephemeral_id": false, "mode": "invisible", "modified_on": "2014-01-01T05:20:00.123123Z", "name": "blog.cloudflare.com login form", "offlabel": false, "region": "world", "sitekey": "0x4AAF00AAAABn0R22HWm-YUc", "deployed_via": "wrangler", "last_modified_via": "dashboard" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ``` ##### 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": [ { "bot_fight_mode": false, "clearance_level": "interactive", "created_on": "2014-01-01T05:20:00.123123Z", "domains": [ "203.0.113.1", "cloudflare.com", "blog.example.com" ], "ephemeral_id": false, "mode": "invisible", "modified_on": "2014-01-01T05:20:00.123123Z", "name": "blog.cloudflare.com login form", "offlabel": false, "region": "world", "sitekey": "0x4AAF00AAAABn0R22HWm-YUc", "deployed_via": "wrangler", "last_modified_via": "dashboard" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ```