--- title: List devices (deprecated) --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Zero Trust](https://developers.cloudflare.com/api/go/resources/zero_trust) [Devices](https://developers.cloudflare.com/api/go/resources/zero_trust/subresources/devices) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List devices (deprecated) Deprecated client.ZeroTrust.Devices.List(ctx, query) (\*SinglePage\[[Device]()], error) GET/accounts/{account\_id}/devices List WARP devices. Not supported when [multi-user mode](https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/windows-multiuser/) is enabled for the account. **Deprecated**: please use one of the following endpoints instead: - GET /accounts/{account\_id}/devices/physical-devices - GET /accounts/{account\_id}/devices/registrations ##### 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
##### ParametersExpand Collapse
query DeviceListParams AccountID param.Field\[string] Link to this property
[Link to this property](<#(resource)%20zero_trust.devices%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type Device struct{…} ID stringOptional Registration ID. Equal to Device ID except for accounts which enabled multi-user mode. maxLength36 Link to this property Created TimeOptional When the device was created. formatdate-time Link to this property Deleted boolOptional True if the device was deleted. Link to this property
DeviceType DeviceDeviceTypeOptional One of the following: const DeviceDeviceTypeWindows DeviceDeviceType = "windows" Link to this property const DeviceDeviceTypeMac DeviceDeviceType = "mac" Link to this property const DeviceDeviceTypeLinux DeviceDeviceType = "linux" Link to this property const DeviceDeviceTypeAndroid DeviceDeviceType = "android" Link to this property const DeviceDeviceTypeIos DeviceDeviceType = "ios" Link to this property const DeviceDeviceTypeChromeos DeviceDeviceType = "chromeos" Link to this property
Link to this property IP stringOptional IPv4 or IPv6 address. Link to this property Key stringOptional The device’s public key. Link to this property LastSeen TimeOptional When the device last connected to Cloudflare services. formatdate-time Link to this property MacAddress stringOptional The device mac address. Link to this property Manufacturer stringOptional The device manufacturer name. Link to this property Model stringOptional The device model name. Link to this property Name stringOptional The device name. Link to this property OSDistroName stringOptional The Linux distro name. Link to this property OSDistroRevision stringOptional The Linux distro revision. Link to this property OSVersion stringOptional The operating system version. Link to this property OSVersionExtra stringOptional Additional operating system version details. For Windows, the UBR (Update Build Revision). For Mac or iOS, the Product Version Extra. For Linux, the distribution name and version. Link to this property RevokedAt TimeOptional When the device was revoked. formatdate-time Link to this property SerialNumber stringOptional The device serial number. Link to this property Updated TimeOptional When the device was updated. formatdate-time Link to this property
User DeviceUserOptional ID stringOptional UUID. maxLength36 Link to this property Email stringOptional The contact email address of the user. maxLength90 Link to this property Name stringOptional The enrolled device user’s name. Link to this property
Link to this property Version stringOptional The WARP client version. Link to this property
[Link to this property](<#(resource)%20zero_trust.devices%20%3E%20(model)%20device%20%3E%20(schema)>) ### List devices (deprecated) Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/zero_trust" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.ZeroTrust.Devices.List(context.TODO(), zero_trust.DeviceListParams{ AccountID: cloudflare.F("699d98642c564d2e855e9661899b7252"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 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": [ { "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "created": "2017-06-14T00:00:00Z", "deleted": true, "device_type": "windows", "ip": "1.1.1.1", "key": "yek0SUYoOQ10vMGsIYAevozXUQpQtNFJFfFGqER/BGc=", "last_seen": "2017-06-14T00:00:00Z", "mac_address": "00-00-5E-00-53-00", "manufacturer": "My phone corp", "model": "MyPhone(pro-X)", "name": "My mobile device", "os_distro_name": "ubuntu", "os_distro_revision": "1.0.0", "os_version": "10.0.0", "os_version_extra": "(a) or 6889 or Ubuntu 24.04", "revoked_at": "2017-06-14T00:00:00Z", "serial_number": "EXAMPLEHMD6R", "updated": "2017-06-14T00:00:00Z", "user": { "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "email": "user@example.com", "name": "John Appleseed" }, "version": "1.0.0" } ], "success": true, "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" } } ], "result": [ { "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "created": "2017-06-14T00:00:00Z", "deleted": true, "device_type": "windows", "ip": "1.1.1.1", "key": "yek0SUYoOQ10vMGsIYAevozXUQpQtNFJFfFGqER/BGc=", "last_seen": "2017-06-14T00:00:00Z", "mac_address": "00-00-5E-00-53-00", "manufacturer": "My phone corp", "model": "MyPhone(pro-X)", "name": "My mobile device", "os_distro_name": "ubuntu", "os_distro_revision": "1.0.0", "os_version": "10.0.0", "os_version_extra": "(a) or 6889 or Ubuntu 24.04", "revoked_at": "2017-06-14T00:00:00Z", "serial_number": "EXAMPLEHMD6R", "updated": "2017-06-14T00:00:00Z", "user": { "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "email": "user@example.com", "name": "John Appleseed" }, "version": "1.0.0" } ], "success": true, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ```