--- title: Devices --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Zero Trust](https://developers.cloudflare.com/api/resources/zero_trust) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Devices ##### [List devices (deprecated)](https://developers.cloudflare.com/api/resources/zero_trust/subresources/devices/methods/list) Deprecated GET/accounts/{account\_id}/devices ##### [Get device (deprecated)](https://developers.cloudflare.com/api/resources/zero_trust/subresources/devices/methods/get) Deprecated GET/accounts/{account\_id}/devices/{device\_id} ##### ModelsExpand Collapse

Device object {id, created, deleted, 17 more }

id: optional string Registration ID. Equal to Device ID except for accounts which enabled multi-user mode. maxLength36 Link to this property created: optional string When the device was created. formatdate-time Link to this property deleted: optional boolean True if the device was deleted. Link to this property

device\_type: optional "windows"or "mac"or "linux"or 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 string IPv4 or IPv6 address. Link to this property key: optional string The device’s public key. Link to this property last\_seen: optional string When the device last connected to Cloudflare services. formatdate-time Link to this property mac\_address: optional string The device mac address. Link to this property manufacturer: optional string The device manufacturer name. Link to this property model: optional string The device model name. Link to this property name: optional string The device name. Link to this property os\_distro\_name: optional string The Linux distro name. Link to this property os\_distro\_revision: optional string The Linux distro revision. Link to this property os\_version: optional string The operating system version. Link to this property os\_version\_extra: optional string 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 string When the device was revoked. formatdate-time Link to this property serial\_number: optional string The device serial number. Link to this property updated: optional string When the device was updated. formatdate-time Link to this property

user: optional object {id, email, name }

id: optional string UUID. maxLength36 Link to this property email: optional string The contact email address of the user. maxLength90 Link to this property name: optional string The enrolled device user’s name. Link to this property

Link to this property version: optional string 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)>)

DeviceGetResponse object {id, account, created, 16 more }

id: optional string Registration ID. Equal to Device ID except for accounts which enabled multi-user mode. maxLength36 Link to this property

account: optional object {id, account\_type, name }

Deprecatedid: optional string Link to this property Deprecatedaccount\_type: optional string Link to this property name: optional string The name of the enrolled account. Link to this property

Link to this property created: optional string When the device was created. formatdate-time Link to this property deleted: optional boolean True if the device was deleted. Link to this property device\_type: optional string Link to this property Deprecatedgateway\_device\_id: optional string Link to this property ip: optional string IPv4 or IPv6 address. Link to this property key: optional string The device’s public key. Link to this property key\_type: optional string Type of the key. Link to this property last\_seen: optional string When the device last connected to Cloudflare services. formatdate-time Link to this property mac\_address: optional string The device mac address. Link to this property model: optional string The device model name. Link to this property name: optional string The device name. Link to this property os\_version: optional string The operating system version. Link to this property serial\_number: optional string The device serial number. Link to this property tunnel\_type: optional string Type of the tunnel connection used. Link to this property updated: optional string When the device was updated. formatdate-time Link to this property

user: optional object {id, email, name }

Link to this property version: optional string The WARP client version. Link to this property

[Link to this property](<#(resource)%20zero_trust.devices%20%3E%20(model)%20device_get_response%20%3E%20(schema)>) #### DevicesDevices ##### [List devices](https://developers.cloudflare.com/api/resources/zero_trust/subresources/devices/subresources/devices/methods/list) GET/accounts/{account\_id}/devices/physical-devices ##### [Get device](https://developers.cloudflare.com/api/resources/zero_trust/subresources/devices/subresources/devices/methods/get) GET/accounts/{account\_id}/devices/physical-devices/{device\_id} ##### [Delete device](https://developers.cloudflare.com/api/resources/zero_trust/subresources/devices/subresources/devices/methods/delete) DELETE/accounts/{account\_id}/devices/physical-devices/{device\_id} ##### [Revoke device registrations](https://developers.cloudflare.com/api/resources/zero_trust/subresources/devices/subresources/devices/methods/revoke) Deprecated POST/accounts/{account\_id}/devices/physical-devices/{device\_id}/revoke ##### ModelsExpand Collapse

DeviceListResponse object {id, active\_registrations, created\_at, 17 more } A WARP Device.

id: string The unique ID of the device. Link to this property active\_registrations: number The number of active registrations for the device. Active registrations are those which haven’t been revoked or deleted. Link to this property created\_at: string The RFC3339 timestamp when the device was created. Link to this property last\_seen\_at: string The RFC3339 timestamp when the device was last seen. Link to this property name: string The name of the device. Link to this property tags: map\[string] Tags assigned to the device. An empty object if the device has no tags. Link to this property updated\_at: string The RFC3339 timestamp when the device was last updated. Link to this property client\_version: optional string Version of the WARP client. Link to this property deleted\_at: optional string The RFC3339 timestamp when the device was deleted. Link to this property device\_type: optional string The device operating system. Link to this property hardware\_id: optional string A string that uniquely identifies the hardware or virtual machine (VM). Link to this property

last\_seen\_registration: optional object {policy } The last seen registration for the device.

policy: optional object {id, default, deleted, 2 more } A summary of the device profile evaluated for the registration.

id: string The ID of the device settings profile. Link to this property default: boolean Whether the device settings profile is the default profile for the account. Link to this property deleted: boolean Whether the device settings profile was deleted. Link to this property name: string The name of the device settings profile. Link to this property updated\_at: string The RFC3339 timestamp of when the device settings profile last changed for the registration. Link to this property