Devices are any Network device managed or monitored by Juniper Mist. It can be * Wireless Access Points * Juniper Switch (EX, QFX) * Juniper WAN Gateway (SRX, SSR) * Mist Edges * Other or 3rd party devices, like Cradlepoint Devices
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 Devices API
version: 2606.1.1
x-logo:
altText: Juniper-MistAI
backgroundColor: '#FFFFFF'
url: https://www.mist.com/wp-content/uploads/logo.png
servers:
- description: Mist Global 01
url: https://api.mist.com
- description: Mist Global 02
url: https://api.gc1.mist.com
- description: Mist Global 03
url: https://api.ac2.mist.com
- description: Mist Global 04
url: https://api.gc2.mist.com
- description: Mist Global 05
url: https://api.gc4.mist.com
- description: Mist EMEA 01
url: https://api.eu.mist.com
- description: Mist EMEA 02
url: https://api.gc3.mist.com
- description: Mist EMEA 03
url: https://api.ac6.mist.com
- description: Mist EMEA 04
url: https://api.gc6.mist.com
- description: Mist APAC 01
url: https://api.ac5.mist.com
- description: Mist APAC 02
url: https://api.gc5.mist.com
- description: Mist APAC 03
url: https://api.gc7.mist.com
security:
- apiToken: []
- csrfToken: []
tags:
- description: Devices are any Network device managed or monitored by Juniper Mist. It can be * Wireless Access Points * Juniper Switch (EX, QFX) * Juniper WAN Gateway (SRX, SSR) * Mist Edges * Other or 3rd party devices, like Cradlepoint Devices
name: Orgs Devices
paths:
/api/v1/orgs/{org_id}/devices:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: List devices in the organization, including APs, switches and gateways managed or monitored by Mist.
operationId: listOrgDevices
responses:
'200':
$ref: '#/components/responses/OrgDevices'
'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: listOrgDevices
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/count:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Count organization device records, optionally grouped by `distinct` and filtered by device identifiers, model, LLDP attributes, Mist Edge, tunnel status, device type, and time range.
operationId: countOrgDevices
parameters:
- description: 'Field used to group this count response. enum: `hostname`, `ip`, `lldp_mgmt_addr`, `lldp_port_id`, `lldp_system_desc`, `lldp_system_name`, `mac`, `model`, `mxedge_id`, `mxtunnel_status`, `site_id`, `version`'
in: query
name: distinct
schema:
$ref: '#/components/schemas/org_devices_count_distinct'
- description: Partial / full hostname
in: query
name: hostname
schema:
examples:
- my-hostname
type: string
- 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 device model. Accepts multiple comma-separated values.
in: query
name: model
schema:
examples:
- AP45,AP47D
- MR84
type: string
- deprecated: true
description: 'for switches and gateways, to filter on managed/unmanaged devices. Deprecated in favour of mist_configured. enum: `true`, `false`'
in: query
name: managed
schema:
examples:
- 'true'
type: string
- description: Filter results by MAC address
in: query
name: mac
schema:
examples:
- 5c5b53010101
type: string
- description: Filter results by software version
in: query
name: version
schema:
examples:
- 10.0.0
type: string
- $ref: '#/components/parameters/ip'
- description: 'MxTunnel status, enum: `up`, `down`'
in: query
name: mxtunnel_status
schema:
$ref: '#/components/schemas/count_org_devices_mxtunnel_status'
- description: Mist Edge id, if AP is connecting to a Mist Edge
in: query
name: mxedge_id
schema:
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
format: uuid
type: string
- description: Filter results by LLDP system name
in: query
name: lldp_system_name
schema:
examples:
- my-lldp-system
type: string
- description: Filter results by LLDP system description
in: query
name: lldp_system_desc
schema:
examples:
- my-lldp-system-description
type: string
- description: Filter results by LLDP port identifier
in: query
name: lldp_port_id
schema:
examples:
- ge-0/0/1
type: string
- description: LLDP management IP address
in: query
name: lldp_mgmt_addr
schema:
examples:
- 10.4.2.3
type: string
- description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
in: query
name: type
schema:
$ref: '#/components/schemas/device_type_default_ap'
- $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: countOrgDevices
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/events/count:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Count device event records across the organization, optionally grouped by `distinct` and filtered by site, AP, firmware, model, event text, event type, and time range.
operationId: countOrgDeviceEvents
parameters:
- description: 'Field used to group this count response. enum: `ap`, `apfw`, `model`, `org_id`, `site_id`, `text`, `timestamp`, `type`'
in: query
name: distinct
schema:
$ref: '#/components/schemas/org_devices_events_count_distinct'
- 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: Filter results by AP firmware version
in: query
name: apfw
schema:
examples:
- 10.0.0
type: string
- description: Filter results by device model
in: query
name: model
schema:
examples:
- AP43
type: string
- description: Filter results by event message text
in: query
name: text
schema:
examples:
- Device connected
type: string
- $ref: '#/components/parameters/device_event_type'
- $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: countOrgDeviceEvents
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/events/search:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Search device event records across the organization with filters for MAC address, model, device type, event text, event type, additional event indices, and time range.
operationId: searchOrgDeviceEvents
parameters:
- description: Filter results by MAC address. Accepts multiple comma-separated values.
in: query
name: mac
schema:
examples:
- 5c5b53010101,5c5b53020202
- 5c5b53010101
type: string
- description: Filter results by device model. Accepts multiple comma-separated values.
in: query
name: model
schema:
examples:
- EX4100-48MP,AP17
- AP43
type: string
- description: Filter results by device type. Accepts multiple comma-separated values.
example: switch,ap
in: query
name: device_type
schema:
$ref: '#/components/schemas/device_type_with_all'
- description: Filter results by event message text
in: query
name: text
schema:
examples:
- Device connected
type: string
- description: See [List Device Events Definitions](/#operations/listDeviceEventsDefinitions). Accepts multiple comma-separated values.
in: query
name: type
schema:
examples:
- SW_PORT_DOWN,AP_CONFIGURED
type: string
- description: Return last/recent event for passed in field
in: query
name: last_by
schema:
examples:
- port_id
type: string
- description: Keyword to include events from additional indices (e.g. ext_tunnel for prisma events)
in: query
name: includes
schema:
examples:
- ext_tunnel
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/DeviceEventsSearch'
'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: searchOrgDeviceEvents
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/last_config/count:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Count device config history records across the organization, optionally grouped by `distinct` and filtered by device type and time range.
operationId: countOrgDeviceLastConfigs
parameters:
- description: 'Filter results by type. enum: `ap`, `gateway`, `switch`'
in: query
name: type
schema:
$ref: '#/components/schemas/device_type_default_ap'
- description: 'Field used to group this count response. enum: `mac`, `name`, `site_id`, `version`'
in: query
name: distinct
schema:
$ref: '#/components/schemas/org_devices_last_configs_count_distinct'
- $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: countOrgDeviceLastConfigs
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/last_config/search:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Search device config history records across the organization with filters for device type, MAC address, name, software version, certificate-expiry duration, and time range.
operationId: searchOrgDeviceLastConfigs
parameters:
- description: 'Filter results by device type. enum: `ap`, `gateway`, `switch`, `mxedge`'
in: query
name: device_type
schema:
$ref: '#/components/schemas/last_config_device_type'
- description: Filter results by MAC address. Accepts multiple comma-separated values.
in: query
name: mac
schema:
examples:
- 5c5b53010101,5c5b53020202
- 5c5b53010101
type: string
- description: Filter results by name. Accepts multiple comma-separated values.
in: query
name: name
schema:
examples:
- name-a,name-b
- My AP
type: string
- description: Filter results by software version. Accepts multiple comma-separated values.
in: query
name: version
schema:
examples:
- apfw-0.15.34615-noro-0a3c,apfw-0.15.34436-noro-d810
- 10.0.0
type: string
- description: 'Duration for expiring cert queries (format: 2d/3h/172800 seconds)'
in: query
name: cert_expiry_duration
schema:
examples:
- 2d
type: string
- $ref: '#/components/parameters/start'
- $ref: '#/components/parameters/end'
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/duration'
- $ref: '#/components/parameters/sort'
- $ref: '#/components/parameters/search_after'
responses:
'200':
$ref: '#/components/responses/ConfigsHistorySearch'
'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: searchOrgDeviceLastConfigs
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/radio_macs:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: 'For some scenarios like E911 or security systems, the BSSIDs are required to identify which AP the client is connecting to. Then the location of the AP can be used as the approximate location of the client.
Each radio MAC can have up to 16 BSSIDs. These are derived by incrementing the least significant hexadecimal digit (last nibble) of the MAC address from 0 to F, while keeping the remaining bits unchanged.'
operationId: listOrgApsMacs
parameters:
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/page'
responses:
'200':
$ref: '#/components/responses/RadioMacs'
'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: listOrgApsMacs
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/search:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Search organization devices with filters for AP radio attributes, gateway HA attributes, switch EVPN attributes, LLDP data, MAC address, IP address, model, software version, site, Mist Edge, and time range. Set `stats=true` to include device stats in the response.
operationId: searchOrgDevices
parameters:
- description: When `type`==`ap`, Channel of band_24. Accepts multiple comma-separated integer values.
in: query
name: band_24_channel
schema:
examples:
- 1,64
type: integer
- description: When `type`==`ap`, Channel of band_5. Accepts multiple comma-separated integer values.
in: query
name: band_5_channel
schema:
examples:
- 153,108
type: integer
- description: When `type`==`ap`, Channel of band_6. Accepts multiple comma-separated integer values.
in: query
name: band_6_channel
schema:
examples:
- 197,221
type: integer
- description: When `type`==`ap`, Bandwidth of band_24. Accepts multiple comma-separated integer values.
in: query
name: band_24_bandwidth
schema:
examples:
- 0,20
type: integer
- description: When `type`==`ap`, Bandwidth of band_5. Accepts multiple comma-separated integer values.
in: query
name: band_5_bandwidth
schema:
examples:
- 20,40
type: integer
- description: When `type`==`ap`, Bandwidth of band_6. Accepts multiple comma-separated integer values.
in: query
name: band_6_bandwidth
schema:
examples:
- 80,40
type: integer
- description: When `type`==`ap`, Power of band_24. Accepts multiple comma-separated integer values.
in: query
name: band_24_power
schema:
examples:
- 0,17
type: integer
- description: When `type`==`ap`, Power of band_5. Accepts multiple comma-separated integer values.
in: query
name: band_5_power
schema:
examples:
- 17,11
type: integer
- description: When `type`==`ap`, Power of band_6. Accepts multiple comma-separated integer values.
in: query
name: band_6_power
schema:
examples:
- 14,12
type: integer
- description: When `type`==`gateway`, true / false
in: query
name: clustered
schema:
type: boolean
- description: When `type`==`ap`, Port speed of eth0. Accepts multiple comma-separated integer values.
in: query
name: eth0_port_speed
schema:
examples:
- 100,1000
- 100
- 1000
type: integer
- description: When `type`==`switch`, EVPN topology id
in: query
name: evpntopo_id
schema:
format: uuid
type: string
- description: Partial / full Device external ip. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `1.2.3.*` and `*.2.3.*` match `1.2.3.4`). Suffix-only wildcards (e.g. `*.2.3.4`) are not supported. Accepts multiple comma-separated values.
in: query
name: ext_ip
schema:
examples:
- 1.2.3.4,1.2.3.*
- 1.2.3.4
- 1.2.3.*
- '*2.3.*'
type: string
- description: Partial / full Device hostname. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `my-london*` and `*london*` match `my-london-1`). Suffix-only wildcards (e.g. `*london-1`) are not supported. Accepts multiple comma-separated values.
in: query
name: hostname
schema:
examples:
- my-london-1,my-london*
- my-london-1
- my-london*
- '*london*'
type: string
- description: Partial / full Device 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: When `type`==`switch` or `type`==`gateway`, last configuration status
in: query
name: last_config_status
schema:
examples:
- success
type: string
- description: Last hostname of the device. Accepts multiple comma-separated values.
in: query
name: last_hostname
schema:
examples:
- ap-01,ap-02
type: string
- description: When `type`==`ap`, LLDP management IP address. Accepts multiple comma-separated values.
in: query
name: lldp_mgmt_addr
schema:
examples:
- 192.0.2.10,192.0.2.11
type: string
- description: When `type`==`ap`, LLDP port id. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `ge-0/0/*` and `*-0/0/*` match `ge-0/0/30`). Suffix-only wildcards (e.g. `*switch-01`) are not supported. Accepts multiple comma-separated values.
in: query
name: lldp_port_id
schema:
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
type: string
- $ref: '#/components/parameters/partial_filter_lldp_system_desc'
- description: When `type`==`ap`, LLDP system name. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `my-switch*` and `*switch*` match `my-switch-01`). Suffix-only wildcards (e.g. `*switch-01`) are not supported. Accepts multiple comma-separated values.
in: query
name: lldp_system_name
schema:
examples:
- richmond-hill-switch,Phoenix_Switch
type: string
- description: Partial / full Device MAC address. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `001122*` and `*1122*` match `001122334455`). Suffix-only wildcards (e.g. `*4455`) are not supported. Accepts multiple comma-separated values.
in: query
name: mac
schema:
examples:
- aabbccddeeff,aabbcc*
- aabbccddeeff
- aabbcc*
- '*bbcc*'
type: string
- description: Partial / full Device model. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `AP4*` and `*P4*` match `AP43`). Suffix-only wildcards (e.g. `*43`) are not supported. Accepts multiple comma-separated values.
in: query
name: model
schema:
examples:
- AP43,AP4*
- AP43
- AP4*
- '*P4*'
type: string
- description: When `type`==`ap`, Mist Edge id, if AP is connecting to a Mist Edge. Accepts multiple comma-separated values.
in: query
name: mxedge_id
schema:
examples:
- 00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002
format: uuid
type: string
- description: When `type`==`ap`, Comma separated list of Mist Edge id, if AP is connecting to a Mist Edge
in: query
name: mxedge_ids
schema:
type: string
- description: 'When `type`==`ap`, Mist Tunnel status used to filter results. enum: `down`, `up`'
in: query
name: mxtunnel_status
schema:
$ref: '#/components/schemas/search_org_devices_mxtunnel_status'
- description: 'When `type`==`gateway`. enum: `node0`, `node1`'
in: query
name: node
schema:
$ref: '#/components/schemas/ha_cluster_node_enum'
- description: When `type`==`gateway`, node0 MAC address
in: query
name: node0_mac
schema:
type: string
- description: When `type`==`gateway`, node1 MAC address
in: query
name: node1_mac
schema:
type: string
- description: When `type`==`ap`, whether the AP is power constrained.
in: query
name: power_constrained
schema:
type: boolean
- description: "When `type`==`switch` or `type`==`gateway`, Key-value pairs where the key\nis the RADIUS server address and the value contains authentication statistics:\n * <server_address> (string): IP address of the RADIUS server as the key\n * `auth_accepts` (long): Number of accepted authentication requests\n * `auth_rejects` (long): Number of rejected authentication requests\n * `auth_timeouts` (long): Number of authentication timeouts\n * `auth_server_status` (string): Status of the server. Possible values: `up`, `down`, `unreachable`"
in: query
name: radius_stats
schema:
type: string
- description: Filter results by site identifier
in: query
name: site_id
schema:
examples:
- 7dae216d-7c98-a51b-e068-dd7d477b7216
type: string
- description: Whether to return device stats
in: query
name: stats
schema:
default: false
type: boolean
- description: When `type`==`gateway` (SSR only), version of 128T agent
in: query
name: t128agent_version
schema:
type: string
- $ref: '#/components/parameters/device_type'
- description: Filter results by software version. Accepts multiple comma-separated values.
in: query
name: version
schema:
examples:
- 0.15.34615,0.14.29967
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/DevicesSearch'
'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: searchOrgDevices
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/devices/summary:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: Return aggregate organization device counts by device category and assignment state.
operationId: listOrgDevicesSummary
responses:
'200':
$ref: '#/components/responses/OrgDevicesSummary'
'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: listOrgDevicesSummary
tags:
- Orgs Devices
/api/v1/orgs/{org_id}/ocdevices/outbound_ssh_cmd:
parameters:
- $ref: '#/components/parameters/org_id'
get:
description: 'Get Org Juniper Devices command
Juniper devices can be managed/adopted by Mist. Currently outbound-ssh + netconf is used.
A few lines of CLI commands are generated per-Org, allowing the Juniper devices to phone home to Mist.'
operationId: getOrgJuniperDevicesCommand
parameters:
- description: Filter results by site identifier
in: query
name: site_id
schema:
type: string
responses:
'200':
$ref: '#/components/responses/JunosRegisterCmd'
'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: getOrgJuniperDevicesCommand
tags:
- Orgs Devices
components:
parameters:
partial_filter_lldp_system_desc:
description: When `type`==`ap`, LLDP system description. Use `prefix*` for prefix search or `*substring*` for contains search (e.g. `Juniper Networks*` and `*Networks*` match `Juniper Networks, Inc.`). Suffix-only wildcards (e.g. `*switch-01`) are not supported
in: query
name: lldp_system_desc
schema:
type: string
sort:
description: On which field the list should be sorted, -prefix represents DESC order
in: query
name: sort
schema:
default: timestamp
examples:
- -site_id
type: string
device_event_type:
description: See [List Device Events Definitions](/#operations/listDeviceEventsDefinitions)
in: query
name: type
schema:
type: string
end:
description: Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d`, `-2h`, or `now`
in: query
name: end
schema:
type: string
org_id:
in: path
name: org_id
required: true
schema:
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
format: uuid
type: string
duration:
description: Time range duration for the query, using relative units such as `10m`, `7d`, or `2w`
in: query
name: duration
schema:
default: 1d
examples:
- 10m
type: string
device_type:
description: 'Device type used to filter results. enum: `ap`, `gateway`, `switch`'
in: query
name: type
schema:
$ref: '#/components/schemas/device_type_default_ap'
page:
description: Select the page number to return when using page-based pagination; starts at `1`
in: query
name: page
schema:
default: 1
minimum: 1
type: integer
ip:
description: Filter results by IPv4 address
in: query
name: ip
schema:
examples:
- 192.168.1.1
format: ipv4
type: string
start:
description: Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as `-1d` or `-1w`
in: query
name: start
schema:
type: string
limit:
description: Maximum number of results to return per page
in: query
name: limit
schema:
default: 100
minimum: 0
type: integer
search_after:
description: Pagination cursor for retrieving subsequent pages of results. This
# --- truncated at 32 KB (80 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mist/refs/heads/main/openapi/mist-orgs-devices-api-openapi.yml