Mist Orgs Clients - Wireless API
Wireless Clients are Wi-Fi devices connected to a Juniper Mist Access Point.
OpenAPI Specification
openapi: 3.1.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 Admins Orgs Clients - Wireless 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: Wireless Clients are Wi-Fi devices connected to a Juniper Mist Access Point.
name: Orgs Clients - Wireless
paths:
/api/v1/orgs/{org_id}/clients/count:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Count wireless client records across the organization, optionally grouped by `distinct` and filtered by client identity, AP, SSID, VLAN, IP, and time range.
operationId: countOrgWirelessClients
parameters:
- description: 'Field used to group this count response. enum: `ap`, `device`, `hostname`, `ip`, `mac`, `model`, `os`, `ssid`, `vlan`'
in: query
name: distinct
schema:
$ref: '#/components/schemas/org_clients_count_distinct'
- description: Partial / full Client MAC address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `aabbcc*` and `*bbcc*` match `aabbccddeeff`). Suffix-only wildcards (e.g. `*bccddeeff`) are not supported. Accepts multiple comma-separated values.
in: query
name: mac
schema:
examples:
- aabbccddeeff,aabbcc*
- aabbccddeeff
- aabbcc*
- '*bbcc*'
type: string
- description: Partial / full Client hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `everest*` and `*rest*` match `my-everest-client`). Suffix-only wildcards (e.g. `*everest`) are not supported. Accepts multiple comma-separated values.
in: query
name: hostname
schema:
examples:
- my-everest-client,my-everest*
- my-everest-client
- my-everest*
- '*everest*'
type: string
- description: Filter results by device type
in: query
name: device
schema:
examples:
- iPhone
type: string
- description: Filter results by operating system
in: query
name: os
schema:
examples:
- Windows 10
type: string
- description: Filter results by device model
in: query
name: model
schema:
examples:
- iPhone 8
type: string
- description: Filter results by AP MAC address
in: query
name: ap
schema:
examples:
- 5c5b53010101
type: string
- description: Filter results by VLAN ID
in: query
name: vlan
schema:
examples:
- '10'
type: string
- description: Filter results by SSID
in: query
name: ssid
schema:
examples:
- MySSID
type: string
- $ref: '#/components/parameters/ip'
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/duration'
- $ref: '#/components/parameters/limit'
responses:
'200':
$ref: '#/components/responses/Count'
'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: countOrgWirelessClients
tags:
- Orgs Clients - Wireless
/api/v1/orgs/{org_id}/clients/events/count:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Count wireless client event records across the organization, optionally grouped by event attributes and filtered by event type, WLAN, radio, site, and time range.
operationId: countOrgWirelessClientEvents
parameters:
- description: 'Field used to group this count response. enum: `band`, `channel`, `proto`, `ssid`, `type`, `wlan_id`'
example: type
in: query
name: distinct
schema:
$ref: '#/components/schemas/site_client_events_count_distinct'
- description: See [List Device Events Definitions](/#operations/listDeviceEventsDefinitions). Accepts multiple comma-separated values.
in: query
name: type
schema:
examples:
- MARVIS_EVENT_CLIENT_AUTH_FAILURE,CLIENT_DEAUTHENTICATION
type: string
- description: Reason code filter for association and disassociation events
in: query
name: reason_code
schema:
type: integer
- description: Filter results by SSID
in: query
name: ssid
schema:
type: string
- description: Filter results by AP MAC address
in: query
name: ap
schema:
type: string
- $ref: '#/components/parameters/dot11_proto'
- $ref: '#/components/parameters/dot11_band'
- description: Filter results by WLAN identifier
in: query
name: wlan_id
schema:
type: string
- description: Filter results by site identifier
in: query
name: site_id
schema:
examples:
- 72771e6a-6f5e-4de4-a5b9-1266c4197811
format: uuid
type: string
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/duration'
- $ref: '#/components/parameters/limit'
responses:
'200':
$ref: '#/components/responses/Count'
'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: countOrgWirelessClientEvents
tags:
- Orgs Clients - Wireless
/api/v1/orgs/{org_id}/clients/events/search:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Search wireless client event records across the organization with filters for event type, reason code, SSID, AP, key management, protocol, band, WLAN, NAC rule, and time range.
operationId: searchOrgWirelessClientEvents
parameters:
- description: See [List Device Events Definitions](/#operations/listDeviceEventsDefinitions). Accepts multiple comma-separated values.
in: query
name: type
schema:
examples:
- CLIENT_IP_ASSIGNED,CLIENT_DEAUTHENTICATION
type: string
- description: Reason code filter for association and disassociation events. Accepts multiple comma-separated integer values.
in: query
name: reason_code
schema:
examples:
- 0,14
- 7
type: string
- description: Filter results by SSID. Accepts multiple comma-separated values.
in: query
name: ssid
schema:
examples:
- Corp,Guest
- MySSID
type: string
- description: Filter results by AP MAC address. Accepts multiple comma-separated values.
in: query
name: ap
schema:
examples:
- 5c5b53010101,5c5b53020202
- 5c5b53010101
type: string
- description: 'Key management protocol used to filter client events. enum: `WPA2-PSK`, `WPA2-PSK/CCMP`, `WPA2-PSK-FT`, `WPA2-PSK-SHA256`, `WPA3-EAP-SHA256`, `WPA3-EAP-SHA256/CCMP`, `WPA3-EAP-FT/GCMP256`, `WPA3-SAE-FT`, `WPA3-SAE-PSK`. Accepts multiple comma-separated values.'
example: WPA2-PSK,WPA2-PSK/CCMP
in: query
name: key_mgmt
schema:
type: string
- description: '802.11 protocol used to filter results. enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`. Accepts multiple comma-separated values.'
example: ax,ac
in: query
name: proto
schema:
type: string
- description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`. Accepts multiple comma-separated values.'
example: 6,5
in: query
name: band
schema:
type: string
- description: Filter results by WLAN identifier
in: query
name: wlan_id
schema:
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
format: uuid
type: string
- description: Filter results by NAC rule identifier. Accepts multiple comma-separated values.
in: query
name: nacrule_id
schema:
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
- 7dae216d-7c98-a51b-e068-dd7d477b7216
format: uuid
type: string
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/duration'
- $ref: '#/components/parameters/sort'
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/search_after'
responses:
'200':
$ref: '#/components/responses/EventsSearch'
'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: searchOrgWirelessClientEvents
tags:
- Orgs Clients - Wireless
/api/v1/orgs/{org_id}/clients/search:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Search wireless client records across the organization with filters for site, AP, band, device identity, hostname, IP, MAC address, username, SSID, PPSK, VLAN, and time range.
operationId: searchOrgWirelessClients
parameters:
- description: Filter results by site identifier
in: query
name: site_id
schema:
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
format: uuid
type: string
- description: Filter results by AP MAC address
in: query
name: ap
schema:
examples:
- 5c5b53010101
type: string
- description: 'Comma separated list of Radio band (e.g. `24,5`). enum: `24`, `5`, `6`'
in: query
name: band
schema:
examples:
- 5,6
- '5'
type: string
- description: Comma separated list of Device type (e.g. `Mac,iPhone`). Case sensitive
in: query
name: device
schema:
examples:
- iPhone
type: string
- description: Partial / full Client hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `everest*` and `*rest*` match `my-everest-client`). Suffix-only wildcards (e.g. `*everest`) are not supported. Accepts multiple comma-separated values.
in: query
name: hostname
schema:
examples:
- my-everest-client,my-everest*
- my-everest-client
- my-everest*
- '*everest*'
type: string
- description: Partial / full Client IP address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `10.100.10.*` and `*100.10.*` match `10.100.10.54`). Suffix-only wildcards (e.g. `*.54`) are not supported. Accepts multiple comma-separated values.
in: query
name: ip
schema:
examples:
- 10.100.10.54,10.100.10.*
- 10.100.10.54
- 10.100.10.*
- '*100.10.*'
type: string
- description: Partial / full Client MAC address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `aabbcc*` and `*bbcc*` match `aabbccddeeff`). Suffix-only wildcards (e.g. `*bccddeeff`) are not supported. Accepts multiple comma-separated values.
in: query
name: mac
schema:
examples:
- aabbccddeeff,aabbcc*
- aabbccddeeff
- aabbcc*
- '*bbcc*'
type: string
- description: Only available for clients running the Marvis Client app, model, e.g. "MBP 15 late 2013", 6, 6s, "8+ GSM"
in: query
name: model
schema:
examples:
- iPhone 8
type: string
- description: Only available for clients running the Marvis Client app, os, e.g. Sierra, Yosemite, Windows 10
in: query
name: os
schema:
examples:
- Windows 10
type: string
- $ref: '#/components/parameters/psk_id_query'
- description: Only available for clients using PPSK authentication, the Name of the PSK
in: query
name: psk_name
schema:
examples:
- MyPPSK
type: string
- description: Filter results by SSID
in: query
name: ssid
schema:
examples:
- MySSID
type: string
- description: Partial / full MAC address, hostname, username, psk_name or ip. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `everest*` and `*rest*` match `my-everest-client`). Suffix-only wildcards (e.g. `*everest`) are not supported
in: query
name: text
schema:
examples:
- 5c5b530
type: string
- description: Partial / full username. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `johndoe*` and `*mycorp*` match `johndoe@mycorp.com`). Suffix-only wildcards (e.g. `*mycorp.com`) are not supported. Accepts multiple comma-separated values.
in: query
name: username
schema:
examples:
- johndoe,johnd*
- johndoe
- johnd*
- '*ohnd*'
type: string
- description: Filter results by VLAN ID
in: query
name: vlan
schema:
examples:
- '10'
type: string
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/duration'
- $ref: '#/components/parameters/sort'
- $ref: '#/components/parameters/search_after'
responses:
'200':
$ref: '#/components/responses/ClientsSearch'
'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: searchOrgWirelessClients
tags:
- Orgs Clients - Wireless
/api/v1/orgs/{org_id}/clients/sessions/count:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Count historical wireless client sessions across the organization, optionally grouped by `distinct` and filtered by AP, band, client attributes, SSID, WLAN, and time range.
operationId: countOrgWirelessClientsSessions
parameters:
- description: 'Field used to group this count response. enum: `ap`, `device`, `hostname`, `ip`, `model`, `os`, `ssid`, `vlan`'
in: query
name: distinct
schema:
$ref: '#/components/schemas/org_client_sessions_count_distinct'
- description: Filter results by AP MAC address
in: query
name: ap
schema:
examples:
- 5c5b53010101
type: string
- $ref: '#/components/parameters/dot11_band'
- description: E.g. "Mac", "iPhone", "Apple watch"
in: query
name: client_family
schema:
examples:
- iPhone
type: string
- description: Filter results by client manufacturer, e.g. "Apple"
in: query
name: client_manufacture
schema:
examples:
- Apple
type: string
- description: Filter results by client model, e.g. "8+", "XS"
in: query
name: client_model
schema:
examples:
- iPhone 8
type: string
- description: E.g. "Mojave", "Windows 10", "Linux"
in: query
name: client_os
schema:
examples:
- Windows 10
type: string
- description: Filter results by SSID
in: query
name: ssid
schema:
examples:
- MySSID
type: string
- description: Filter results by WLAN identifier
in: query
name: wlan_id
schema:
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
format: uuid
type: string
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/duration'
- $ref: '#/components/parameters/limit'
responses:
'200':
$ref: '#/components/responses/Count'
'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: countOrgWirelessClientsSessions
tags:
- Orgs Clients - Wireless
/api/v1/orgs/{org_id}/clients/sessions/search:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Search historical wireless client sessions across the organization with filters for AP, band, client family, manufacturer, model, OS, username, SSID, WLAN, PPSK, and time range.
operationId: searchOrgWirelessClientSessions
parameters:
- description: Filter results by AP MAC address
in: query
name: ap
schema:
examples:
- 5c5b53010101
type: string
- description: '802.11 band used to filter radio results. enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`. Accepts multiple comma-separated values.'
example: 5,6
in: query
name: band
schema:
type: string
- description: E.g. "Mac", "iPhone", "Apple watch". Accepts multiple comma-separated values.
in: query
name: client_family
schema:
examples:
- Phone/Tablet/Wearable,Monitoring Device
- iPhone
type: string
- description: Filter results by client manufacturer, e.g. "Apple". Accepts multiple comma-separated values.
in: query
name: client_manufacture
schema:
examples:
- Hewlett Packard Enterprise,Unknown
- Apple
type: string
- description: Filter results by client model, e.g. "8+", "XS". Accepts multiple comma-separated values.
in: query
name: client_model
schema:
examples:
- iPhone 8,Aruba S0U52A
- iPhone 8
type: string
- description: Filter results by client username. Accepts multiple comma-separated values.
in: query
name: client_username
schema:
examples:
- john.doe,jane.doe
- john.doe
type: string
- description: E.g. "Mojave", "Windows 10", "Linux". Accepts multiple comma-separated values.
in: query
name: client_os
schema:
examples:
- iOS 16.7.16,Unknown
- Windows 10
type: string
- description: Filter results by SSID. Accepts multiple comma-separated values.
in: query
name: ssid
schema:
examples:
- Corp,Guest
- MySSID
type: string
- description: Filter results by WLAN identifier
in: query
name: wlan_id
schema:
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
format: uuid
type: string
- $ref: '#/components/parameters/psk_id_query'
- description: Filter results by PSK name. Accepts multiple comma-separated values.
in: query
name: psk_name
schema:
examples:
- psk-a,psk-b
- MyPPSK
type: string
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/duration'
- $ref: '#/components/parameters/sort'
- $ref: '#/components/parameters/search_after'
responses:
'200':
$ref: '#/components/responses/WirelessClientSessionsSearch'
'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: searchOrgWirelessClientSessions
tags:
- Orgs Clients - Wireless
components:
schemas:
client_wireless_app_version:
description: Only when client has the Marvis Client app running. List of the versions of the Marvis Client
examples:
- - 0.100.3
items:
type: string
type: array
wireless_client_session_tags:
description: Tags attached to a wireless client session
items:
type: string
readOnly: true
type: array
org_client_sessions_count_distinct:
default: device
description: 'enum: `ap`, `device`, `hostname`, `ip`, `model`, `os`, `ssid`, `vlan`'
enum:
- ap
- device
- hostname
- ip
- model
- os
- ssid
- vlan
type: string
wireless_client_session:
additionalProperties: false
description: Wireless client session record returned by a session search
properties:
ap:
description: MAC address of the access point associated with the client session
readOnly: true
type: string
band:
description: Radio band used by the client session
readOnly: true
type: string
client_manufacture:
description: Manufacturer reported for the client device, when available
readOnly: true
type:
- string
- 'null'
connect:
description: Time when the client session connected, in epoch seconds
readOnly: true
type: integer
disconnect:
description: Time when the client session disconnected, in epoch seconds
readOnly: true
type: integer
duration:
description: Length of the client session, in seconds
readOnly: true
type: number
for_site:
description: Whether this client session record is scoped to a site
readOnly: true
type: boolean
mac:
description: Client MAC address for the session
readOnly: true
type: string
org_id:
$ref: '#/components/schemas/org_id'
description: Organization associated with the client session
site_id:
$ref: '#/components/schemas/site_id'
description: Site associated with the client session
ssid:
description: WLAN SSID used by the client session
readOnly: true
type: string
tags:
$ref: '#/components/schemas/wireless_client_session_tags'
description: Event or classification tags attached to the client session
timestamp:
$ref: '#/components/schemas/timestamp'
description: Time when the client session record was observed, in epoch seconds
wlan_id:
description: Identifier of the WLAN associated with the client session
format: uuid
readOnly: true
type: string
required:
- ap
- band
- connect
- disconnect
- duration
- mac
- org_id
- site_id
- ssid
- timestamp
- wlan_id
type: object
client_wireless_vlan:
description: List of vlans that have been assigned to the client
examples:
- - 10
items:
type: integer
type: array
timestamp:
description: Epoch timestamp, in seconds
format: double
readOnly: true
type: number
dot11_band:
description: 'enum: `24`, `5`, `5-dedicated`, `5-selectable`, `6`, `6-dedicated`, `6-selectable`'
enum:
- '24'
- '5'
- 5-dedicated
- 5-selectable
- '6'
- 6-dedicated
- 6-selectable
type: string
response_http429:
additionalProperties: false
description: Standard HTTP 429 rate limit error response
properties:
detail:
description: Human-readable explanation of the rate limit error
examples:
- Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
type: string
type: object
org_id:
description: Unique identifier of a Mist organization
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
format: uuid
readOnly: true
type: string
response_http401:
additionalProperties: false
description: Standard HTTP 401 authentication error response
properties:
detail:
description: Human-readable explanation of the authentication error
examples:
- Authentication credentials were not provided.
type: string
type: object
last_vlan:
description: Latest VLAN ID assigned to the client
examples:
- 10
type: integer
response_client_search:
additionalProperties: false
description: Paginated wireless client search response
properties:
end:
description: Search window end timestamp for wireless clients, in epoch seconds
type: number
limit:
description: Maximum number of wireless client results requested
type: integer
next:
description: URL for the next page of wireless client results
type: string
results:
$ref: '#/components/schemas/response_client_search_results'
description: Wireless client records returned for this page
start:
description: Search window start timestamp for wireless clients, in epoch seconds
type: number
total:
description: Number of wireless client records matching the search
type: integer
required:
- start
- end
- limit
- total
- results
type: object
client_wireless_os_version:
description: Only when client is having the Marvis Client app running. List of OS version detected for the client
examples:
- - 14.4.1 (Build 23E224)
items:
type: string
type: array
response_http403:
additionalProperties: false
description: Standard HTTP 403 permission error response
properties:
detail:
description: Human-readable explanation of the permission error
examples:
- You do not have permission to perform this action.
type: string
type: object
last_device:
description: Latest type of device we identified (e.g. iPhone, Mac, ...)
examples:
- Zebra
type: string
count_results:
description: List of count result rows
items:
$ref: '#/components/schemas/count_result'
type: array
uniqueItems: true
client_wireless_ssid:
description: List of the WLAN names the client was connected to
examples:
- - IoT SSID
items:
type: string
type: array
client_wireless_hostname:
description: List of hostname detected for this client
examples:
- - hostname-a
- hostname-b
items:
type: string
type: array
last_username:
description: If dot1x authentication, the username used during the latest authentication. Otherwise, the MAC address of the client
examples:
- john@mycorp.net
type: string
response_events_search:
additionalProperties: false
description: Paginated response for wireless client event search results
properties:
end:
description: Epoch timestamp for the end of the wireless client event search window
type: integer
limit:
description: Maximum number of wireless client event records returned in this page
type: integer
next:
description: Pagination cursor or URL for retrieving the next page of wireless client event records
type: string
results:
$ref: '#/components/schemas/response_events_search_results'
description: Wireless client event records matching the search filters
start:
description: Epoch timestamp for the start of the wireless client event search window
type: integer
total:
description: Number of wireless client event records matching the search filters across all pages
type: integer
required:
- start
- end
- limit
- total
- results
type: object
response_events_search_results:
description: Wireless client event records returned by a search response
items:
$ref: '#/components/schemas/events_client'
type: array
uniqueItems: true
site_client_events_count_distinct:
description: 'enum: `band`, `channel`, `proto`, `ssid`, `type`, `wlan_id`'
enum:
# --- truncated at 32 KB (58 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mist/refs/heads/main/openapi/mist-orgs-clients-wireless-api-openapi.yml