--- title: List devices (deprecated) --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Zero Trust](https://developers.cloudflare.com/api/python/resources/zero_trust) [Devices](https://developers.cloudflare.com/api/python/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 zero\_trust.devices.list(DeviceListParams\*\*kwargs) -> SyncSinglePage\[[Device]()] 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 account\_id: str [Link to this property](<#(resource)%20zero_trust.devices%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class Device: … id: Optional\[str] Registration ID. Equal to Device ID except for accounts which enabled multi-user mode. maxLength36 Link to this property created: Optional\[datetime] When the device was created. formatdate-time Link to this property deleted: Optional\[bool] True if the device was deleted. Link to this property
device\_type: Optional\[Literal\["windows", "mac", "linux", 3 more]] One of the following: "windows" Link to this property "mac" Link to this property "linux" Link to this property "android" Link to this property "ios" Link to this property "chromeos" Link to this property
Link to this property ip: Optional\[str] IPv4 or IPv6 address. Link to this property key: Optional\[str] The device’s public key. Link to this property last\_seen: Optional\[datetime] When the device last connected to Cloudflare services. formatdate-time Link to this property mac\_address: Optional\[str] The device mac address. Link to this property manufacturer: Optional\[str] The device manufacturer name. Link to this property model: Optional\[str] The device model name. Link to this property name: Optional\[str] The device name. Link to this property os\_distro\_name: Optional\[str] The Linux distro name. Link to this property os\_distro\_revision: Optional\[str] The Linux distro revision. Link to this property os\_version: Optional\[str] The operating system version. Link to this property os\_version\_extra: Optional\[str] 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 revoked\_at: Optional\[datetime] When the device was revoked. formatdate-time Link to this property serial\_number: Optional\[str] The device serial number. Link to this property updated: Optional\[datetime] When the device was updated. formatdate-time Link to this property
user: Optional\[User] id: Optional\[str] UUID. maxLength36 Link to this property email: Optional\[str] The contact email address of the user. maxLength90 Link to this property name: Optional\[str] The enrolled device user’s name. Link to this property
Link to this property version: Optional\[str] 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) 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.zero_trust.devices.list( account_id="699d98642c564d2e855e9661899b7252", ) page = page.result[0] print(page.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": [ { "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 } } ```