--- title: Get Device DEX test --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Zero Trust](https://developers.cloudflare.com/api/resources/zero_trust) [Devices](https://developers.cloudflare.com/api/resources/zero_trust/subresources/devices) [DEX Tests](https://developers.cloudflare.com/api/resources/zero_trust/subresources/devices/subresources/dex_tests) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get Device DEX test GET/accounts/{account\_id}/dex/devices/dex\_tests/{dex\_test\_id} Fetch a single DEX test. ##### 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) `Cloudflare DEX Write``Cloudflare DEX Read``Zero Trust Report``Zero Trust Read` ##### P ath ParametersExpand Collapse account\_id: string Unique identifier linked to an account. maxLength32 [Link to this property](<#(resource)%20zero_trust.devices.dex_tests%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) dex\_test\_id: string The unique identifier for the test. maxLength32 [Link to this property](<#(resource)%20zero_trust.devices.dex_tests%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20dex_test_id%20%3E%20(schema)>) ##### ReturnsExpand Collapse

errors: array of object {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)%20zero_trust.devices.dex_tests%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)

messages: array of object {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)%20zero_trust.devices.dex_tests%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20messages>) success: true Whether the API call was successful. [Link to this property](<#(resource)%20zero_trust.devices.dex_tests%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20success>)

result: optional SchemaHTTP { data, enabled, interval, 7 more }

data: SchemaData { host, kind, method } The configuration object which contains the details for the WARP client to conduct the test.

host: string The desired endpoint to test. Link to this property

kind: "http"or "traceroute" The type of test.

One of the following: "http" Link to this property "traceroute" Link to this property

Link to this property method: optional "GET" The HTTP request method type. Link to this property

Link to this property enabled: boolean Determines whether or not the test is active. Link to this property interval: string How often the test will run. Link to this property name: string The name of the DEX test. Must be unique. Link to this property created: optional string Date the test was created, in RFC 3339 format. formatdate-time Link to this property description: optional string Additional details about the test. Link to this property

target\_policies: optional array of object {id, default, name } DEX rules targeted by this test

id: string The id of the DEX rule. maxLength36 Link to this property default: optional boolean Whether the DEX rule is the account default. Link to this property name: optional string The name of the DEX rule. Link to this property

Link to this property targeted: optional boolean Link to this property test\_id: optional string The unique identifier for the test. maxLength32 Link to this property updated: optional string Date the test was last updated, in RFC 3339 format. formatdate-time Link to this property

[Link to this property](<#(resource)%20zero_trust.devices.dex_tests%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20result>) ### Get Device DEX test HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/dex/devices/dex_tests/$DEX_TEST_ID \ -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": { "data": { "host": "https://dash.cloudflare.com", "kind": "http", "method": "GET" }, "enabled": true, "interval": "30m", "name": "HTTP dash health check", "created": "2023-10-11T00:00:00Z", "description": "Checks the dash endpoint every 30 minutes", "target_policies": [ { "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "default": true, "name": "name" } ], "targeted": true, "test_id": "372e67954025e0ba6aaa6d586b9e0b59", "updated": "2023-10-11T00:00:00Z" } } ``` ##### 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": { "data": { "host": "https://dash.cloudflare.com", "kind": "http", "method": "GET" }, "enabled": true, "interval": "30m", "name": "HTTP dash health check", "created": "2023-10-11T00:00:00Z", "description": "Checks the dash endpoint every 30 minutes", "target_policies": [ { "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "default": true, "name": "name" } ], "targeted": true, "test_id": "372e67954025e0ba6aaa6d586b9e0b59", "updated": "2023-10-11T00:00:00Z" } } ```