Mist Orgs Clients - Wireless API

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 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_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
    last_client_ip:
      description: The last known IP address for the client
      examples:
      - 10.100.0.157
      type: string
    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
    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_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
    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_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_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
    client_wireless_username:
      description: Only for 802.1X authentication. List of usernames used by the client
      examples:
      - - user@corp.com
      items:
        type: string
      type: array
    org_id:
      description: Unique identifier of a Mist organization
      examples:
      - a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
      format: uuid
      readOnly: true
      type: string
    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
    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
    response_events_search_results:
      description: Wireless client event records returned by a search response
      items:
        $ref: '#/components/schemas/events_client'
      type: array
      uniqueItems: true
    response_count:
      additionalProperties: false
      description: Distinct count response for time-bounded search results
      properties:
        distinct:
          description: Field used to group the count results
          type: string
        end:
          description: Search window end timestamp for the count request, in epoch seconds
          type: integer
        limit:
          description: Maximum number of distinct count results requested
          type: integer
        results:
          $ref: '#/components/schemas/count_results'
          description: Count results grouped by the distinct field
        start:
          description: Search window start timestamp for the count request, in epoch seconds
          type: integer
        total:
          description: Number of distinct result buckets returned
          type: integer
      required:
      - distinct
      - end
      - limit
      - results
      - start
      - total
      type: object
    client_wireless_vlan:
      description: List of vlans that have been assigned to the client
      examples:
      - - 10
      items:
        type: integer
      type: array
    last_device:
      description: Latest type of device we identified (e.g. iPhone, Mac, ...)
      examples:
      - Zebra
      type: string
    org_clients_count_distinct:
      default: device
      description: 'enum: `ap`, `device`, `hostname`, `ip`, `mac`, `model`, `os`, `ssid`, `vlan`'
      enum:
      - ap
      - device
      - hostname
      - ip
      - mac
      - model
      - os
      - ssid
      - vlan
      type: string
    last_vlan:
      description: Latest VLAN ID assigned to the client
      examples:
      - 10
      type: integer
    dot11_proto:
      description: 'enum: `a`, `ac`, `ax`, `b`, `be`, `g`, `n`'
      enum:
      - a
      - ac
      - ax
      - b
      - be
      - g
      - n
      type: string
    client_wireless_site_ids:
      description: List of Mist Site IDs where the client was connected
      examples:
      - - 25ff5219-9be7-4db9-907d-0c9b60445147
      items:
        format: uuid
        type: string
      type: array
    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
    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_key_mgmt:
      description: 'Key management protocol used for the latest authentication. 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`'
      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
      examples:
      - WPA2-PSK
      type: string
    last_ap:
      description: Latest AP where the client is/was connected to
      examples:
      - a83a79a947ee
      type: string
    wireless_client_session_tags:
      description: Tags attached to a wireless client session
      items:
        type: string
      readOnly: true
      type: array
    count_results:
      description: List of count result rows
      items:
        $ref: '#/components/schemas/count_result'
      type: array
      uniqueItems: true
    timestamp:
      description: Epoch timestamp, in seconds
      format: double
      readOnly: true
      type: number
    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
    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
        

# --- 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