Mist Sites Clients - Wireless API

Wireless Clients are Wi-Fi devices connected to a Juniper Mist Access Point.

OpenAPI Specification

mist-sites-clients-wireless-api-openapi.yml Raw ↑
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 Sites 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: Sites Clients - Wireless
paths:
  /api/v1/sites/{site_id}/clients/count:
    parameters:
    - $ref: '#/components/parameters/site_id'
    get:
      description: Count wireless clients for a site, optionally grouped by the `distinct` field and filtered by client attributes and time range. Use [Count Org Wireless Clients](/#operations/countOrgWirelessClients) to count wireless clients across the organization.
      operationId: countSiteWirelessClients
      parameters:
      - description: 'Field used to group this count response. enum: `ap`, `device`, `hostname`, `ip`, `model`, `os`, `ssid`, `vlan`'
        example: hostname
        in: query
        name: distinct
        schema:
          $ref: '#/components/schemas/site_clients_count_distinct'
      - 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/ip'
      - description: Filter client results by VLAN ID
        in: query
        name: vlan
        schema:
          type: string
      - description: Filter results by hostname
        in: query
        name: hostname
        schema:
          type: string
      - description: Filter client results by operating system
        in: query
        name: os
        schema:
          type: string
      - description: Filter results by device model
        in: query
        name: model
        schema:
          type: string
      - description: Filter client results by device type
        in: query
        name: device
        schema:
          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: countSiteWirelessClients
      tags:
      - Sites Clients - Wireless
  /api/v1/sites/{site_id}/clients/events/count:
    parameters:
    - $ref: '#/components/parameters/site_id'
    get:
      description: Count wireless client events for a site, optionally grouped by the `distinct` field and filtered by event attributes and time range. Use [Count Org Wireless Client Events](/#operations/countOrgWirelessClientEvents) to count wireless client events across the organization.
      operationId: countSiteWirelessClientEvents
      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'
      - $ref: '#/components/parameters/client_event_type'
      - 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
      - $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: countSiteWirelessClientEvents
      tags:
      - Sites Clients - Wireless
  /api/v1/sites/{site_id}/clients/events/search:
    parameters:
    - $ref: '#/components/parameters/site_id'
    get:
      description: Search wireless client events for a site with filters for event type, AP, SSID, WLAN, radio band, and time range. Use [Search Org Wireless Client Events](/#operations/searchOrgWirelessClientEvents) to search wireless client events across the organization.
      operationId: searchSiteWirelessClientEvents
      parameters:
      - $ref: '#/components/parameters/client_event_type'
      - 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 NAC rule identifier
        in: query
        name: nacrule_id
        schema:
          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/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: searchSiteWirelessClientEvents
      tags:
      - Sites Clients - Wireless
  /api/v1/sites/{site_id}/clients/search:
    parameters:
    - $ref: '#/components/parameters/site_id'
    get:
      description: Search wireless clients connected to a site with filters for client identity, AP, SSID, VLAN, radio band, and time range. Fuzzy matching with `*` is supported on `mac`, `hostname`, `device`, `os`, and `model`, for example `/clients/search?device=Mac*&hostname=jerry`. Use [Search Org Wireless Clients](/#operations/searchOrgWirelessClients) to search wireless clients across the organization.
      operationId: searchSiteWirelessClients
      parameters:
      - 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'
          type: string
      - description: Comma separated list of Device type (e.g. `Mac,iPhone`). Case sensitive
        in: query
        name: device
        schema:
          examples:
          - iPhone
          type: string
      - $ref: '#/components/parameters/partial_filter_hostname_client'
      - $ref: '#/components/parameters/partial_filter_ip_client'
      - $ref: '#/components/parameters/partial_filter_mac_client'
      - 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. `*client`) are not supported
        in: query
        name: text
        schema:
          examples:
          - 5c5b530
          type: string
      - $ref: '#/components/parameters/partial_search_username'
      - 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: searchSiteWirelessClients
      tags:
      - Sites Clients - Wireless
  /api/v1/sites/{site_id}/clients/sessions/count:
    parameters:
    - $ref: '#/components/parameters/site_id'
    get:
      description: Count wireless client sessions for a site, optionally grouped by the `distinct` field and filtered by AP, SSID, WLAN, client attributes, and time range. Use [Count Org Wireless Client Sessions](/#operations/countOrgWirelessClientsSessions) to count wireless client sessions across the organization.
      operationId: countSiteWirelessClientSessions
      parameters:
      - description: 'Field used to group this count response. enum: `ap`, `client_family`, `client_manufacture`, `client_model`, `client_os`, `mac`, `ssid`, `wlan_id`'
        in: query
        name: distinct
        schema:
          $ref: '#/components/schemas/site_client_sessions_count_distinct'
      - description: Filter results by AP MAC address
        in: query
        name: ap
        schema:
          type: string
      - $ref: '#/components/parameters/dot11_band'
      - description: E.g. "Mac", "iPhone", "Apple watch"
        in: query
        name: client_family
        schema:
          type: string
      - description: Filter results by client manufacturer, e.g. "Apple"
        in: query
        name: client_manufacture
        schema:
          type: string
      - description: Filter results by client model, e.g. "8+", "XS"
        in: query
        name: client_model
        schema:
          type: string
      - description: E.g. "Mojave", "Windows 10", "Linux"
        in: query
        name: client_os
        schema:
          type: string
      - description: Filter results by SSID
        in: query
        name: ssid
        schema:
          type: string
      - description: Filter results by WLAN identifier
        in: query
        name: wlan_id
        schema:
          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: countSiteWirelessClientSessions
      tags:
      - Sites Clients - Wireless
  /api/v1/sites/{site_id}/clients/sessions/search:
    parameters:
    - $ref: '#/components/parameters/site_id'
    get:
      description: Search wireless client sessions for a site with filters for AP, SSID, WLAN, client attributes, PSK, and time range. Use [Search Org Wireless Client Sessions](/#operations/searchOrgWirelessClientSessions) to search wireless client sessions across the organization.
      operationId: searchSiteWirelessClientSessions
      parameters:
      - description: Filter results by AP MAC address
        in: query
        name: ap
        schema:
          type: string
      - $ref: '#/components/parameters/dot11_band'
      - description: E.g. "Mac", "iPhone", "Apple watch"
        in: query
        name: client_family
        schema:
          type: string
      - description: Filter results by client manufacturer, e.g. "Apple"
        in: query
        name: client_manufacture
        schema:
          type: string
      - description: Filter results by client model, e.g. "8+", "XS"
        in: query
        name: client_model
        schema:
          type: string
      - description: Filter results by client username
        in: query
        name: client_username
        schema:
          type: string
      - description: E.g. "Mojave", "Windows 10", "Linux"
        in: query
        name: client_os
        schema:
          type: string
      - description: Filter results by SSID
        in: query
        name: ssid
        schema:
          type: string
      - description: Filter results by WLAN identifier
        in: query
        name: wlan_id
        schema:
          type: string
      - $ref: '#/components/parameters/psk_id_query'
      - description: Filter results by PSK name
        in: query
        name: psk_name
        schema:
          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/ClientSessionsSearch'
        '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: searchSiteWirelessClientSessions
      tags:
      - Sites Clients - Wireless
  /api/v1/sites/{site_id}/clients/{client_mac}/events:
    parameters:
    - $ref: '#/components/parameters/site_id'
    - $ref: '#/components/parameters/client_mac'
    get:
      description: Get the list of events for a specific client
      operationId: getSiteEventsForClient
      parameters:
      - description: Filter results by type, e.g. MARVIS_EVENT_CLIENT_DHCP_STUCK
        in: query
        name: type
        schema:
          type: string
      - $ref: '#/components/parameters/dot11_proto'
      - $ref: '#/components/parameters/dot11_band'
      - description: Filter available versions by release channel
        in: query
        name: channel
        schema:
          type: string
      - description: Filter results by WLAN identifier
        in: query
        name: wlan_id
        schema:
          type: string
      - description: Filter results by SSID
        in: query
        name: ssid
        schema:
          type: string
      - $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/ClientEventsSearch'
        '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: getSiteEventsForClient
      tags:
      - Sites 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
    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
    response_client_sessions_search_results:
      description: Wireless client session records returned by a search response
      items:
        $ref: '#/components/schemas/response_client_sessions_search_item'
      type: array
    response_client_sessions_search:
      additionalProperties: false
      description: Paginated wireless client session search response
      properties:
        end:
          description: Search window end timestamp for wireless client sessions, in epoch seconds
          type: integer
        limit:
          description: Maximum number of wireless client session results requested
          type: integer
        next:
          description: URL for the next page of wireless client session results
          type: string
        results:
          $ref: '#/components/schemas/response_client_sessions_search_results'
          description: Wireless client session records returned for this page
        start:
          description: Search window start timestamp for wireless client sessions, in epoch seconds
          type: integer
        total:
          description: Number of wireless client session records matching the search
          type: integer
      required:
      - end
      - limit
      - results
      - start
      - total
      type: object
    client_wireless_hostname:
      description: List of hostname detected for this client
      examples:
      - - hostname-a
        - hostname-b
      items:
        type: string
      type: array
    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
    site_client_events_count_distinct:
      description: 'enum: `band`, `channel`, `proto`, `ssid`, `type`, `wlan_id`'
      enum:
      - band
      - channel
      - proto
      - ssid
      - type
      - wlan_id
      type: string
    response_http400:
      additionalProperties: false
      description: Standard HTTP 400 bad request error response
      properties:
        detail:
          description: Human-readable explanation of the bad request error
          examples:
          - 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
          type: string
      type: object
    client_wireless_psk_name:
      description: List of names of the PPSK used by the client
      examples:
      - - iot
      items:
        type: string
      type: array
    site_id:
      description: Unique identifier of a Mist site
      examples:
      - 441a1214-6928-442a-8e92-e1d34b8ec6a6
      format: uuid
      readOnly: true
      type: string
    site_client_sessions_count_distinct:
      default: mac
      description: 'enum: `ap`, `client_family`, `client_manufacture`, `client_model`, `client_os`, `mac`, `ssid`, `wlan_id`'
      enum:
      - ap
      - client_family
      - client_manufacture
      - client_model
      - client_os
      - mac
      - ssid
      - wlan_id
      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
    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
    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_ssid:
      description: List of the WLAN names the client was connected to
      examples:
      - - IoT SSID
      items:
        type: string
      type: array
    response_events_search_results:
      description: Wireless client event records returned by a search response
      items:
        $ref: '#/components/schemas/events_client'
      type: array
      uniqueItems: true
    dot11_proto:
      description: 'enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`'
      enum:
      - a
      - ac
      - ax
      - b
      - be
      - g
      - n
      type: string
    last_client_ip:
      description: The last known IP address for the client
      examples:
      - 10.100.0.157
      type: string
    response_client_events_search_results:
      description: Client event records returned by a search response
      items:
        $ref: '#/components/schemas/events_client'
      type: array
      uniqueItems: true
    client_wireless_ap:
      description: List of AP MAC addresses the client was connected to
      examples:
      - - a83a79a947ee
        - 003e73170b4c
      items:
        type: string
      type: array
    count_result:
      additionalProperties:
        type: string
      description: Count result row with the matching distinct field values
      properties:
        count:
          description: Number of matching items for the distinct value or values in this result
          type: integer
      required:
      - count
      type: object
    client_wireless_ip:
      description: List if the IP addresses detected for this client
      examples:
      - - 10.5.23.43
        - 192.168.0.2
      items:
        type: string
      type: array
    client_wireless_psk_id:
      description: List of IDs of the PPSK used by the client
      examples:
      - - abf7dc5c-bb51-4bb7-93b6-5547400ffe11
      items:
        format: uuid
        type: string
      type: array
    response_client_events_search:
      additionalProperties: false
      description: Paginated client event search response
      properties:
        end:
          description: Search window end timestamp for client events, in epoch seconds
          type: integer
        limit:
          description: Maximum number of client event results requested
          type: integer
        next:
          description: URL for the next page of client event results
          type: string
        results:
          $ref: '#/components/schemas/response_client_events_search_results'
          description: Client event records returned for this page
        start:
          description: Search window start timestamp for client events, in epoch seconds
          type: integer
        total:
          description: Number of client event records matching the search
          type: integer
      required:
      - start
      - end
      - limit
      - total
      - results
      type: object
    org_id:
      description: Unique identifier of a Mist organization
      examples:
      - a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
      format: uuid
      readOnly: true
      type: string
    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
    count_results:
      description: List of count result rows
      items:
        $ref: '#/components/schemas/count_result'
      type: array
      uniqueItems: true
    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
    client_wireless_device:
      description: Only when client has the Marvis Client app running. List of the type of device type detected
      examples:
      - - Mac
      items:
        type: string
      type: array
    events_client:
      additionalProperties: false
      description: Wireless client event returned by client event search APIs
      properties:
        ap:
          description: Access point MAC address associated with the wireless client event
          type: string
        band:
          $ref: '#/components/schemas/dot11_band'
          description: Radio band used for the wireless client event
        bssid:
          description: Wireless BSSID involved in the client event
          type: string
        channel:
          description: Radio channel used for the wireless client event
          type: integer
        key_mgmt:
          $ref: '#/components/schemas/client_key_mgmt'
          description: Key management protocol used by the client session
        proto:
          $ref: '#/components/schemas/dot11_proto'
          description: 802.11 protocol used by the client session
        ssid:
          description: Wireless network SSID involved in the client event
          type: string
        text:
          description: Human-readable message for the client event
          type: string
        timestamp:
          $ref: '#/components/schemas/timestamp'
          description: Time when the client event occurred
        type:
          description: Event type, e.g. MARVIS_EVENT_CLIENT_FBT_FAILURE
          type: string
        type_code:
          description: Reason code for association or disassociation client events
          type: integer
        wlan_id:
          description: Wireless LAN identifier associated with the client event
          format: uuid
          type: string
      required:
      - timestamp
      - band
      type: object
    client_wireless_os:
      description: Only when client is having the Marvis Client app running. List of OS detected for the client
      examples:
      - - Sonoma
      items:
        type: string
      type: array
    client_wireless_sdk_version:
      description: Only when client has the Marvis Client app running. List of Marvis Client SDK version detected for the client
      examples:
      - - 0.100.3
      items:
        type: string
      type: array
    site_clients_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
    response_count:
      additionalProperties: false
      description: Distinct count response for time-bounded search results
      properties:
        distinct

# --- truncated at 32 KB (58 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mist/refs/heads/main/openapi/mist-sites-clients-wireless-api-openapi.yml