--- title: Get live aggregate device details by dimension --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [Zero Trust](https://developers.cloudflare.com/api/typescript/resources/zero_trust) [DEX](https://developers.cloudflare.com/api/typescript/resources/zero_trust/subresources/dex) [Fleet Status](https://developers.cloudflare.com/api/typescript/resources/zero_trust/subresources/dex/subresources/fleet_status) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get live aggregate device details by dimension client.zeroTrust.dex.fleetStatus.live(FleetStatusLiveParams {account\_id, since\_minutes } params, RequestOptionsoptions?): [FleetStatusLiveResponse]() {deviceStats } GET/accounts/{account\_id}/dex/fleet-status/live Get details for live (up to 60 minutes) devices using WARP. ##### 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
User Service Key Used when interacting with the Origin CA certificates API. View/change your key. **Example:**X-Auth-User-Service-Key: v1.0-144c9defac04969c7bfad8ef-631a41d003a32d25fe878081ef365c49503f7fada600da935e2851a1c7326084b85cbf6429c4b859de8475731dc92a9c329631e6d59e6c73da7b198497172b4cefe071d90d0f5d2719
##### Accepted Permissions (at least one required) `Cloudflare DEX Write``Cloudflare DEX Read``Zero Trust Report``Zero Trust Read` ##### ParametersExpand Collapse
params: FleetStatusLiveParams {account\_id, since\_minutes } account\_id: string Path param: Unique identifier linked to an account. maxLength32 Link to this property since\_minutes: number Query param: Number of minutes before current time. maximum60 minimum1 Link to this property
[Link to this property](<#(resource)%20zero_trust.dex.fleet_status%20%3E%20(method)%20live%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
FleetStatusLiveResponse {deviceStats }
deviceStats?: DeviceStats {byColo, byMode, byPlatform, 3 more }
byColo?: Array<LiveStat {uniqueDevicesTotal, value } >| null uniqueDevicesTotal?: number Number of unique devices Link to this property value?: string Link to this property
Link to this property
byMode?: Array<LiveStat {uniqueDevicesTotal, value } >| null uniqueDevicesTotal?: number Number of unique devices Link to this property value?: string Link to this property
Link to this property
byPlatform?: Array<LiveStat {uniqueDevicesTotal, value } >| null uniqueDevicesTotal?: number Number of unique devices Link to this property value?: string Link to this property
Link to this property
byStatus?: Array<LiveStat {uniqueDevicesTotal, value } >| null uniqueDevicesTotal?: number Number of unique devices Link to this property value?: string Link to this property
Link to this property
byVersion?: Array<LiveStat {uniqueDevicesTotal, value } >| null uniqueDevicesTotal?: number Number of unique devices Link to this property value?: string Link to this property
Link to this property uniqueDevicesTotal?: number Number of unique devices Link to this property
Link to this property
[Link to this property](<#(resource)%20zero_trust.dex.fleet_status%20%3E%20(model)%20fleet_status_live_response%20%3E%20(schema)>) ### Get live aggregate device details by dimension TypeScript HTTPTypeScriptPythonGoTerraform ``` import Cloudflare from 'cloudflare'; const client = new Cloudflare({ apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted }); const response = await client.zeroTrust.dex.fleetStatus.live({ account_id: '01a7362d577a6c3019a474fd6f485823', since_minutes: 10, }); console.log(response.deviceStats); ``` 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": { "deviceStats": { "byColo": [ { "uniqueDevicesTotal": 0, "value": "value" } ], "byMode": [ { "uniqueDevicesTotal": 0, "value": "value" } ], "byPlatform": [ { "uniqueDevicesTotal": 0, "value": "value" } ], "byStatus": [ { "uniqueDevicesTotal": 0, "value": "value" } ], "byVersion": [ { "uniqueDevicesTotal": 0, "value": "value" } ], "uniqueDevicesTotal": 0 } } } ``` ##### 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": { "deviceStats": { "byColo": [ { "uniqueDevicesTotal": 0, "value": "value" } ], "byMode": [ { "uniqueDevicesTotal": 0, "value": "value" } ], "byPlatform": [ { "uniqueDevicesTotal": 0, "value": "value" } ], "byStatus": [ { "uniqueDevicesTotal": 0, "value": "value" } ], "byVersion": [ { "uniqueDevicesTotal": 0, "value": "value" } ], "uniqueDevicesTotal": 0 } } } ```