# Aggregated fleet stats (/docs/api-reference/fleet/FleetController_getStats)

`GET /api/fleet/stats`

Base URL: https://api.xentr.ai

Authentication: bearer token (`Authorization: Bearer <token>`).

Returns edge counts by status/region, offline count, frozen count, total buffer depth, per-protocol device counts, and cert-expiry buckets. Org-scoped for customer roles; full-fleet for xentr_* staff.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `organizationId` | query | no | string | Organization scope. Required for non-staff; staff may omit for a full-fleet view. |

## Responses

### 200: Fleet stats JSON