API Calls to retrieve statistics about the Mist Managed and Monitored Devices at the Org level By default, the API call only returns a subset of the available fields. Additional fields can be requested by adding the query parameter `fields=` and the list of fields, or `fields=*` to retrieve all the available fields.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mist-orgs-stats-devices-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
contact:
email: tmunzer@juniper.net
name: Thomas Munzer
description: '> Version: **2606.1.1**
>
> Date: **July 10, 2026**
<div class="notification"> NOTE:<br>Some important API changes will be introduced. Please make sure to read the <a href="https://www.juniper.net/documentation/us/en/software/mist/api/http/guides/important-api-changes">announcements</a> </div>
---
## Additional Documentation
* [Mist Automation Guide](https://www.juniper.net/documentation/us/en/software/mist/automation-integration/index.html)
* [Mist Location SDK](https://www.juniper.net/documentation/us/en/software/mist/location-services/topics/concept/mist-how-get-mist-sdk.html)
* [Mist Product Updates](https://www.juniper.net/documentation/us/en/software/mist/product-updates/)
## Helpful Resources
* [API Sandbox and Exercises](https://api-class.mist.com/)
* [Postman Collection, Runners and Webhook Samples](https://www.postman.com/juniper-mist/workspace/mist-systems-s-public-workspace)
* [Python Script Examples](https://github.com/tmunzer/mist_library)
* [API Demo Apps](https://apps.mist-lab.fr/)
* [Juniper Blog](https://blogs.juniper.net/)
## Mist Web Browser Extension:
* Google Chrome, Microsoft Edge and other Chromium-based browser: [Chrome Web Store](https://chromewebstore.google.com/detail/mist-extension/ejhpdcljeamillfhdihkkmoakanpbplh)
* Firefox: [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/mist-extension/)
---'
license:
name: MIT
url: https://raw.githubusercontent.com/tmunzer/Mist-OAS3.0/main/LICENSE
title: Mist Orgs Stats - Devices API
version: 2606.1.1
x-logo:
altText: Juniper-MistAI
backgroundColor: '#FFFFFF'
url: https://www.mist.com/wp-content/uploads/logo.png
servers:
- description: Mist Global 01
url: https://api.mist.com
- description: Mist Global 02
url: https://api.gc1.mist.com
- description: Mist Global 03
url: https://api.ac2.mist.com
- description: Mist Global 04
url: https://api.gc2.mist.com
- description: Mist Global 05
url: https://api.gc4.mist.com
- description: Mist EMEA 01
url: https://api.eu.mist.com
- description: Mist EMEA 02
url: https://api.gc3.mist.com
- description: Mist EMEA 03
url: https://api.ac6.mist.com
- description: Mist EMEA 04
url: https://api.gc6.mist.com
- description: Mist APAC 01
url: https://api.ac5.mist.com
- description: Mist APAC 02
url: https://api.gc5.mist.com
- description: Mist APAC 03
url: https://api.gc7.mist.com
security:
- apiToken: []
- csrfToken: []
tags:
- description: 'API Calls to retrieve statistics about the Mist Managed and Monitored Devices at the Org level
By default, the API call only returns a subset of the available fields. Additional fields can be requested by adding the query parameter `fields=` and the list of fields, or `fields=*` to retrieve all the available fields.'
name: Orgs Stats - Devices
paths:
/api/v1/orgs/{org_id}/stats/devices:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: 'Get List of Org Devices stats
This API renders some high-level device stats, pagination is assumed and returned in response header (as the response is an array)'
operationId: listOrgDevicesStats
parameters:
- description: 'Filter results by one device type. Use a single value; comma-separated values are not supported. enum: `all`, `ap`, `gateway`, `switch`'
in: query
name: type
schema:
$ref: '#/components/schemas/device_enum_with_all'
- description: 'Filter results by status. enum: `all`, `connected`, `disconnected`. Accepts multiple comma-separated values.'
example: disconnected,connected
in: query
name: status
schema:
type: string
- description: Filter results by site identifier. Accepts multiple comma-separated values.
in: query
name: site_id
schema:
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
type: string
- description: Filter results by MAC address. Accepts multiple comma-separated values.
in: query
name: mac
schema:
examples:
- 5c5b53010101,5c5b53020202
type: string
- description: Filter results by evpntopo id
in: query
name: evpntopo_id
schema:
type: string
- description: If `evpn_unused`==`true`, find EVPN eligible switches which don’t belong to any EVPN Topology yet
in: query
name: evpn_unused
schema:
type: string
- $ref: '#/components/parameters/fields'
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/duration'
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/page'
responses:
'200':
$ref: '#/components/responses/DevicesArrayStatsOrg'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listOrgDevicesStats
tags:
- Orgs Stats - Devices
components:
schemas:
port_auth_state:
description: 'Port authentication state. enum: `""`, `authenticated`, `authenticating`, `held`, `init`'
enum:
- ''
- authenticated
- authenticating
- held
- init
type: string
stats_ap_gps_stat:
additionalProperties: false
description: GPS location data reported by an AP
properties:
accuracy:
description: The estimated accuracy or accuracy of the GPS coordinates, measured in meters.
examples:
- 12.5
type: number
altitude:
description: The elevation of the AP above sea level, measured in meters.
examples:
- 99.939
type: number
latitude:
description: The geographic latitude of the AP, measured in degrees.
examples:
- 37.29548
type: number
longitude:
description: The geographic longitude of the AP, measured in degrees.
examples:
- -122.03304
type: number
src:
$ref: '#/components/schemas/stats_ap_gps_stat_src'
description: Source of the GPS location data
timestamp:
$ref: '#/components/schemas/timestamp'
description: Time when the GPS location data was observed, in epoch seconds
type: object
route_summary_stats:
additionalProperties: false
description: Route table capacity and usage summary
properties:
fib_routes:
description: Number of routes installed in the forwarding information base
type: integer
max_unicast_routes_supported:
description: Supported maximum number of unicast routes
type: integer
rib_routes:
description: Number of routes present in the routing information base
type: integer
total_routes:
description: Aggregate number of routes reported by the device
type: integer
type: object
wan_tunnel_protocol:
description: 'Tunnel protocol used for the connection. enum: `gre`, `ipsec`'
enum:
- gre
- ipsec
type: string
org_id:
description: Unique identifier of a Mist organization
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
format: uuid
readOnly: true
type: string
stats_gateway_service_status:
additionalProperties: false
description: Gateway security service installation and runtime status
properties:
appid_install_result:
description: Installation result reported for the AppID package
type: string
appid_install_timestamp:
description: Installation time reported for the AppID package
type: string
appid_status:
description: Operational status of the AppID service on the gateway
type: string
appid_version:
description: Installed AppID package version number
type: integer
ewf_status:
description: Enhanced Web Filtering service status reported by the gateway
type: string
idp_install_result:
description: Installation result reported for the intrusion detection and prevention package
type: string
idp_install_timestamp:
description: Installation time reported for the intrusion detection and prevention package
type: string
idp_policy:
description: Intrusion detection and prevention policy applied to the gateway
type: string
idp_status:
description: Intrusion detection and prevention service status reported by the gateway
type: string
idp_update_timestamp:
description: Last update time reported for the intrusion detection and prevention package
type: string
type: object
module_stat_item_poe:
additionalProperties: false
description: Power over Ethernet telemetry for a device module
properties:
max_power:
description: Total PoE power budget available to the module, in watts
examples:
- 250
type: number
power_draw:
description: Current PoE power draw on the module, in watts
examples:
- 120.3
type: number
status:
description: Operational status of PoE on the module
type: string
type: object
tx_bps:
description: Rate of transmitting traffic, bits/seconds, last known
examples:
- 634301
format: int64
readOnly: true
type:
- integer
- 'null'
rx_bps:
description: Rate of receiving traffic, bits/seconds, last known
examples:
- 60003
format: int64
readOnly: true
type:
- integer
- 'null'
ap_stat_mesh_downlink:
additionalProperties: false
description: Runtime statistics for a mesh downlink from this AP
properties:
band:
description: Radio band used by this mesh downlink
examples:
- '5'
type: string
channel:
description: Radio channel used by this mesh downlink
examples:
- 36
type: integer
idle_time:
description: Seconds since traffic was last observed on this mesh downlink
examples:
- 3
type: integer
last_seen:
$ref: '#/components/schemas/last_seen'
description: Timestamp when this mesh downlink was last observed
proto:
description: 802.11 protocol reported for this mesh downlink
examples:
- n
type: string
rssi:
description: Received signal strength for this mesh downlink, in dBm
examples:
- -65
type: integer
rx_bps:
$ref: '#/components/schemas/rx_bps'
description: Inbound throughput on this mesh downlink, in bits per second
rx_bytes:
$ref: '#/components/schemas/rx_bytes'
description: Inbound byte count for this mesh downlink
rx_packets:
$ref: '#/components/schemas/rx_pkts'
description: Inbound packet count for this mesh downlink
rx_rate:
$ref: '#/components/schemas/rx_rate'
description: Inbound data rate reported for this mesh downlink
rx_retries:
$ref: '#/components/schemas/rx_retries'
description: Inbound retry count reported for this mesh downlink
site_id:
$ref: '#/components/schemas/site_id'
description: Site associated with this mesh downlink statistic
snr:
description: Signal-to-noise ratio for this mesh downlink, in dB
examples:
- 31
type: integer
tx_bps:
$ref: '#/components/schemas/tx_bps'
description: Outbound throughput on this mesh downlink, in bits per second
tx_bytes:
$ref: '#/components/schemas/tx_bytes'
description: Outbound byte count for this mesh downlink
tx_packets:
$ref: '#/components/schemas/tx_pkts'
description: Outbound packet count for this mesh downlink
tx_rate:
$ref: '#/components/schemas/tx_rate'
description: Outbound data rate reported for this mesh downlink
tx_retries:
$ref: '#/components/schemas/tx_retries'
description: Outbound retry count reported for this mesh downlink
type: object
module_stat_item_vc_links_item:
additionalProperties: false
description: Virtual chassis link endpoint for a device module
properties:
neighbor_module_idx:
description: Index of the neighboring module connected through this virtual chassis link
examples:
- 1
type: integer
neighbor_port_id:
description: Port identifier on the neighboring module for this virtual chassis link
examples:
- vcp-255/1/0
type: string
port_id:
description: Local port identifier for this virtual chassis link
examples:
- vcp-255/1/0
type: string
type: object
ap_radio_stat:
additionalProperties: false
description: Runtime radio statistics for an access point radio
properties:
bandwidth:
$ref: '#/components/schemas/dot11_bandwidth'
description: Current channel width reported for this radio
channel:
description: Current channel the radio is running on
readOnly: true
type:
- integer
- 'null'
dynamic_chaining_enabled:
description: Use dynamic chaining for downlink
readOnly: true
type:
- boolean
- 'null'
mac:
description: Radio base MAC address; a base radio MAC can represent up to 16 BSSIDs (e.g. 5c5b350001a0-5c5b350001af)
readOnly: true
type:
- string
- 'null'
noise_floor:
description: Measured noise floor for this radio, in dBm
examples:
- -90
readOnly: true
type:
- integer
- 'null'
num_clients:
description: Number of clients currently connected on this radio
readOnly: true
type:
- integer
- 'null'
num_wlans:
description: How many WLANs are applied to the radio
type: integer
power:
description: Transmit power (in dBm)
readOnly: true
type:
- integer
- 'null'
rx_bytes:
$ref: '#/components/schemas/rx_bytes'
description: Received byte count reported for this radio
rx_pkts:
$ref: '#/components/schemas/rx_pkts'
description: Received packet count reported for this radio
tx_bytes:
$ref: '#/components/schemas/tx_bytes'
description: Transmitted byte count reported for this radio
tx_pkts:
$ref: '#/components/schemas/tx_pkts'
description: Transmitted packet count reported for this radio
usage:
description: Operating band reported for this radio, such as 24, 5, or 6
examples:
- '24'
readOnly: true
type:
- string
- 'null'
util_all:
description: All utilization in percentage
readOnly: true
type:
- integer
- 'null'
util_non_wifi:
description: Reception of "No Packets" utilization in percentage, received frames with invalid PLCPs and CRS glitches as noise
readOnly: true
type:
- integer
- 'null'
util_rx_in_bss:
description: Reception of "In BSS" utilization in percentage, only frames that are received from AP/STAs within the BSS
readOnly: true
type:
- integer
- 'null'
util_rx_other_bss:
description: Reception of "Other BSS" utilization in percentage, all frames received from AP/STAs that are outside the BSS
readOnly: true
type:
- integer
- 'null'
util_tx:
description: Transmission utilization in percentage
readOnly: true
type:
- integer
- 'null'
util_undecodable_wifi:
description: Reception of "UnDecodable Wifi" utilization in percentage, only Preamble, PLCP header is decoded, Rest is undecodable in this radio
readOnly: true
type:
- integer
- 'null'
util_unknown_wifi:
description: Reception of "No Category" utilization in percentage, all 802.11 frames that are corrupted at the receiver
readOnly: true
type:
- integer
- 'null'
type: object
tx_rate:
description: Transmit data rate reported for a wireless or mesh link, in Mbps
format: float
readOnly: true
type:
- number
- 'null'
bgp_peer:
additionalProperties: false
description: Only present when `bgp_peers` in `fields` query parameter
properties:
evpn_overlay:
description: If this is created for evpn overlay
type: boolean
for_overlay:
description: If this is created for overlay
type: boolean
local_as:
$ref: '#/components/schemas/bgp_as'
description: Local Autonomous System (AS) number used by this BGP session
neighbor:
description: IP address of the BGP neighbor
examples:
- 15.8.3.5
type: string
neighbor_as:
$ref: '#/components/schemas/bgp_as'
description: Autonomous System (AS) number of the BGP neighbor
neighbor_mac:
description: MAC address of the BGP neighbor when it is another device in the same organization
examples:
- 020001c04600
type: string
node:
description: HA node reporting this BGP peer, such as node0 or node1
examples:
- node0
type: string
rx_pkts:
$ref: '#/components/schemas/rx_pkts'
description: Packets received from this BGP neighbor
rx_routes:
description: Number of received routes
examples:
- 60
type: integer
state:
$ref: '#/components/schemas/bgp_stats_state'
description: Current state of the BGP session
timestamp:
$ref: '#/components/schemas/timestamp'
description: Time when these BGP peer stats were sampled
tx_pkts:
$ref: '#/components/schemas/tx_pkts'
description: Packets sent to this BGP neighbor
tx_routes:
description: Number of routes advertised to this BGP neighbor
examples:
- 60
type: integer
up:
description: Whether the BGP session is currently up
type: boolean
uptime:
description: Number of seconds the BGP session has been up
examples:
- 31355
type: integer
vrf_name:
description: VRF name associated with this BGP session
examples:
- default
type: string
type: object
stats_gateway_module_stat_item:
additionalProperties: false
description: Hardware module status and firmware inventory for a gateway
properties:
backup_version:
description: Backup software version stored on the gateway module
readOnly: true
type:
- string
- 'null'
bios_version:
description: BIOS firmware version reported for the gateway module
readOnly: true
type:
- string
- 'null'
boot_partition:
description: Active boot partition used by the gateway module
type: string
cpld_version:
description: CPLD firmware version reported for the gateway module
readOnly: true
type:
- string
- 'null'
fans:
$ref: '#/components/schemas/module_stat_item_fans'
description: Cooling fan status records for the gateway module
fpga_version:
description: FPGA firmware version reported for the gateway module
readOnly: true
type:
- string
- 'null'
last_seen:
$ref: '#/components/schemas/last_seen'
description: Time when Mist last observed this gateway module, in epoch seconds
locating:
description: Whether the gateway module locator indicator is active
type: boolean
mac:
description: Gateway module MAC address reported by Mist
examples:
- fc3342123456
type: string
memory_stat:
$ref: '#/components/schemas/memory_stat'
description: Utilization statistics for gateway module memory
model:
description: Gateway module model name reported by Mist
examples:
- EX4300-48P
readOnly: true
type:
- string
- 'null'
network_resources:
$ref: '#/components/schemas/module_stat_item_network_resources'
description: Network resource utilization counters for the gateway module
optics_cpld_version:
description: Optics CPLD firmware version reported for the gateway module
readOnly: true
type:
- string
- 'null'
pending_version:
description: Pending software version staged for the gateway module
readOnly: true
type:
- string
- 'null'
poe:
$ref: '#/components/schemas/module_stat_item_poe'
description: Power over Ethernet telemetry for the gateway module
poe_version:
description: PoE controller firmware version reported for the gateway module
readOnly: true
type:
- string
- 'null'
power_cpld_version:
description: Power CPLD firmware version reported for the gateway module
readOnly: true
type:
- string
- 'null'
psus:
$ref: '#/components/schemas/module_stat_item_psus'
description: Power supply status records for the gateway module
re_fpga_version:
description: Routing Engine FPGA firmware version reported for the gateway module
readOnly: true
type:
- string
- 'null'
recovery_version:
description: Recovery software version stored on the gateway module
readOnly: true
type:
- string
- 'null'
serial:
description: Gateway module serial number reported by Mist
examples:
- PX8716230021
readOnly: true
type:
- string
- 'null'
status:
description: Connection status reported for the gateway module
readOnly: true
type:
- string
- 'null'
temperatures:
$ref: '#/components/schemas/module_stat_item_temperatures'
description: Temperature sensor readings for the gateway module
tmc_fpga_version:
description: TMC FPGA firmware version reported for the gateway module
readOnly: true
type:
- string
- 'null'
uboot_version:
description: U-Boot firmware version reported for the gateway module
readOnly: true
type:
- string
- 'null'
uptime:
description: Elapsed time since the gateway module last booted, in seconds
readOnly: true
type:
- integer
- 'null'
vc_links:
$ref: '#/components/schemas/module_stat_item_vc_links'
description: Virtual chassis link records for the gateway module
vc_mode:
description: Virtual chassis mode reported for the gateway module
readOnly: true
type:
- string
- 'null'
vc_role:
description: 'Virtual chassis role reported for the gateway module. enum: `master`, `backup`, `linecard`'
examples:
- master
readOnly: true
type:
- string
- 'null'
vc_state:
description: Virtual chassis state reported for the gateway module
readOnly: true
type:
- string
- 'null'
version:
description: Software version running on the gateway module
readOnly: true
type:
- string
- 'null'
type: object
strings:
description: Unique string values returned or accepted by this schema
items:
type: string
type: array
uniqueItems: true
stats_devices:
description: Device statistics records returned by a stats response
items:
$ref: '#/components/schemas/stats_device'
type: array
last_seen:
description: Timestamp indicating when the entity was last seen
examples:
- 1470417522
format: double
readOnly: true
type:
- number
- 'null'
stats_cluster_config_ethernet_connection_item:
additionalProperties: false
description: Ethernet interface connection state for a gateway cluster member
properties:
name:
description: Ethernet interface name reported for cluster connectivity
type: string
status:
description: Operational state reported for the Ethernet interface
type: string
type: object
stats_switch_module_stat_item:
additionalProperties: false
description: Hardware module status and firmware inventory for a switch
properties:
backup_version:
description: Backup software version stored on the switch module
readOnly: true
type:
- string
- 'null'
bios_version:
description: BIOS firmware version reported for the switch module
readOnly: true
type:
- string
- 'null'
boot_partition:
description: Active boot partition used by the switch module
type: string
cpld_version:
description: CPLD firmware version reported for the switch module
readOnly: true
type:
- string
- 'null'
cpu_stat:
$ref: '#/components/schemas/cpu_stat'
description: Processor utilization statistics for the switch module
errors:
$ref: '#/components/schemas/module_stat_item_errors'
description: Hardware error records reported for the switch module
fans:
$ref: '#/components/schemas/module_stat_item_fans'
description: Cooling fan status records for the switch module
fpc_idx:
description: FPC index identifying this switch module
readOnly: true
type: integer
fpga_version:
description: FPGA firmware version reported for the switch module
readOnly: true
type:
- string
- 'null'
last_seen:
$ref: '#/components/schemas/last_seen'
description: Time when Mist last observed this switch module, in epoch seconds
locating:
description: Whether the switch module locator indicator is active
type: boolean
mac:
description: Switch module MAC address reported by Mist
examples:
- fc3342123456
type: string
memory_stat:
$ref: '#/components/schemas/memory_stat'
description: Utilization statistics for switch module memory
model:
description: Switch module model name reported by Mist
examples:
- EX4300-48P
readOnly: true
type:
- string
- 'null'
optics_cpld_version:
description: Optics CPLD firmware version reported for the switch module
readOnly: true
type:
- string
- 'null'
pending_version:
description: Pending software version staged for the switch module
readOnly: true
type:
- string
- 'null'
pics:
$ref: '#/components/schemas/module_stat_item_pics'
description: Physical Interface Card status records for the switch module
poe:
$ref: '#/components/schemas/module_stat_item_poe'
description: Power over Ethernet telemetry for the switch module
poe_version:
description: PoE controller firmware version reported for the switch module
readOnly: true
type:
- string
- 'null'
power_cpld_version:
description: Power CPLD firmware version reported for the switch module
readOnly: true
type:
- string
- 'null'
psus:
$ref: '#/components/schemas/module_stat_item_psus'
description: Power supply status records for the switch module
re_fpga_version:
description: Routing Engine FPGA firmware version reported for the switch module
readOnly: true
type:
- string
- 'null'
recovery_version:
description: Recovery software version stored on the switch module
readOnly: true
type:
- string
- 'null'
serial:
description: Switch module serial number reported by Mist
examples:
- PX8716230021
readOnly: true
type:
- string
- 'null'
status:
description: Connection status reported for the switch module
readOnly: true
type:
- string
- 'null'
temperatures:
$ref: '#/components/schemas/module_stat_item_temperatures'
description: Temperature sensor readings for the switch module
tmc_fpga_version:
description: TMC FPGA firmware version reported for the switch module
readOnly: true
type:
- string
- 'null'
type:
description: Module type reported for the switch module
readOnly: true
type:
- string
- 'null'
uboot_version:
description: U-Boot firmware version reported for the switch module
readOnly: true
type:
- string
- 'null'
uptime:
description: Elapsed time since the switch module last booted, in seconds
readOnly: true
type:
- integer
- 'null'
vc_links:
$ref: '#/components/schemas/module_stat_item_vc_links'
description: Virtual chassis link records for the switch module
vc_mode:
description: Virtual chassis mode reported for the switch module
readOnly: true
type:
- string
- 'null'
vc_role:
description: 'enum: `master`, `backup`, `linecard`'
examples:
- master
readOnly: true
type:
- string
- 'null'
vc_state:
description: Virtual chassis state reported for the switch module
readOnly: true
type:
- string
- 'null'
version:
description: Software version running on the switch module
readOnly: true
type:
- string
- 'null'
type: object
stats_ap_auto_placement_info:
additionalProperties: false
description: Additional diagnostics for
# --- truncated at 32 KB (175 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mist/refs/heads/main/openapi/mist-orgs-stats-devices-api-openapi.yml