Mist Constants Models API
API Calls to retrieve the list of Hardware Models and their features
OpenAPI Specification
openapi: 3.1.0
info:
contact:
email: tmunzer@juniper.net
name: Thomas Munzer
description: '> Version: **2606.1.1**
>
> Date: **July 10, 2026**
<div class="notification"> NOTE:<br>Some important API changes will be introduced. Please make sure to read the <a href="https://www.juniper.net/documentation/us/en/software/mist/api/http/guides/important-api-changes">announcements</a> </div>
---
## Additional Documentation
* [Mist Automation Guide](https://www.juniper.net/documentation/us/en/software/mist/automation-integration/index.html)
* [Mist Location SDK](https://www.juniper.net/documentation/us/en/software/mist/location-services/topics/concept/mist-how-get-mist-sdk.html)
* [Mist Product Updates](https://www.juniper.net/documentation/us/en/software/mist/product-updates/)
## Helpful Resources
* [API Sandbox and Exercises](https://api-class.mist.com/)
* [Postman Collection, Runners and Webhook Samples](https://www.postman.com/juniper-mist/workspace/mist-systems-s-public-workspace)
* [Python Script Examples](https://github.com/tmunzer/mist_library)
* [API Demo Apps](https://apps.mist-lab.fr/)
* [Juniper Blog](https://blogs.juniper.net/)
## Mist Web Browser Extension:
* Google Chrome, Microsoft Edge and other Chromium-based browser: [Chrome Web Store](https://chromewebstore.google.com/detail/mist-extension/ejhpdcljeamillfhdihkkmoakanpbplh)
* Firefox: [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/mist-extension/)
---'
license:
name: MIT
url: https://raw.githubusercontent.com/tmunzer/Mist-OAS3.0/main/LICENSE
title: Mist Admins Constants Models API
version: 2606.1.1
x-logo:
altText: Juniper-MistAI
backgroundColor: '#FFFFFF'
url: https://www.mist.com/wp-content/uploads/logo.png
servers:
- description: Mist Global 01
url: https://api.mist.com
- description: Mist Global 02
url: https://api.gc1.mist.com
- description: Mist Global 03
url: https://api.ac2.mist.com
- description: Mist Global 04
url: https://api.gc2.mist.com
- description: Mist Global 05
url: https://api.gc4.mist.com
- description: Mist EMEA 01
url: https://api.eu.mist.com
- description: Mist EMEA 02
url: https://api.gc3.mist.com
- description: Mist EMEA 03
url: https://api.ac6.mist.com
- description: Mist EMEA 04
url: https://api.gc6.mist.com
- description: Mist APAC 01
url: https://api.ac5.mist.com
- description: Mist APAC 02
url: https://api.gc5.mist.com
- description: Mist APAC 03
url: https://api.gc7.mist.com
security:
- apiToken: []
- csrfToken: []
tags:
- description: API Calls to retrieve the list of Hardware Models and their features
name: Constants Models
paths:
/api/v1/const/default_gateway_config:
get:
description: Generate the default gateway configuration for the requested model and HA mode.
operationId: getGatewayDefaultConfig
parameters:
- description: Device model for which to generate the default gateway config.
in: query
name: model
required: true
schema:
examples:
- srx550
type: string
- description: Whether the config is intended for HA
in: query
name: ha
schema:
examples:
- 'false'
type: string
responses:
'200':
$ref: '#/components/responses/ConstDefaultGatewayConfig'
'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: getGatewayDefaultConfig
tags:
- Constants Models
/api/v1/const/device_models:
get:
description: Return AP, Switch and Gateway device models supported by Mist, including their features and capabilities.
operationId: listDeviceModels
responses:
'200':
$ref: '#/components/responses/ConstDeviceModels'
'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: listDeviceModels
tags:
- Constants Models
/api/v1/const/mxedge_models:
get:
description: Return Mist Edge models supported by Mist, including their capabilities.
operationId: listMxEdgeModels
responses:
'200':
$ref: '#/components/responses/ConstMxEdgeModels'
'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: listMxEdgeModels
tags:
- Constants Models
/api/v1/const/otherdevice_models:
get:
description: Return supported models for other or third-party devices.
operationId: listSupportedOtherDeviceModels
responses:
'200':
$ref: '#/components/responses/ConstOtherDeviceModels'
'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: listSupportedOtherDeviceModels
tags:
- Constants Models
components:
schemas:
const_device_switch:
additionalProperties: false
description: Switch model capability definition returned by the constants API
properties:
alias:
description: Alternate model identifier for chassis-based switch definitions
examples:
- EX4100-48P-CHAS
type: string
defaults:
$ref: '#/components/schemas/const_device_switch_default'
description: Default port mappings for this switch model
description:
description: Product description for the switch model
examples:
- Juniper EX4100 Series
type: string
display:
description: User-facing model name shown for the switch
examples:
- EX4100-48P
type: string
evolved_os:
default: false
description: Whether the switch model runs Junos Evolved
type: boolean
evpn_ri_type:
description: EVPN routing-instance type used by this switch model
examples:
- mac-vrf
type: string
experimental:
default: false
description: Whether this switch model is marked experimental in the constants catalog
type: boolean
fans_pluggable:
default: false
description: Whether the switch model has field-replaceable fans
examples:
- true
type: boolean
has_bgp:
default: false
description: Whether the switch model supports BGP
examples:
- true
type: boolean
has_ets:
default: false
description: Whether the switch model supports Enhanced Transmission Selection (ETS)
type: boolean
has_evpn:
default: false
description: Whether the switch model supports EVPN
examples:
- true
type: boolean
has_irb:
default: false
description: Whether the switch model supports IRB interfaces
examples:
- true
type: boolean
has_poe_out:
default: false
description: Whether the switch model supports PoE output
examples:
- true
type: boolean
has_snapshot:
default: true
description: Whether the switch model supports configuration snapshots
type: boolean
has_vc:
default: true
description: Whether the switch model supports Virtual Chassis
examples:
- true
type: boolean
model:
description: Switch model identifier for this capability definition
examples:
- EX4100-48P
type: string
modular:
default: false
description: Whether the switch model has modular hardware
type: boolean
no_shaping_rate:
default: false
description: Whether the switch model omits shaping-rate support
type: boolean
number_fans:
description: Number of fans in the switch model
examples:
- 2
type: integer
oc_device:
default: false
description: Whether this switch model is identified as an OpenConfig-managed device
examples:
- true
type: boolean
oob_interface:
description: Out-of-band management interface names for this switch model
examples:
- re0:mgmt-0, re1:mgmt-0
type: string
packet_action_drop_only:
default: false
description: Whether packet action support is limited to drop-only behavior
type: boolean
pic:
additionalProperties:
description: List of type and number of ports (e.g. "mge*8, ge*16")
type: string
description: Object Key is the PIC number
examples:
- '0': ge*48
'1': qsfp+*4
'2': sfp+*4 (uplink)
type: object
sub_required:
description: Subscription type required for this switch model
type: string
type:
$ref: '#/components/schemas/const_device_type_switch'
description: Device type for this switch model definition
required:
- type
type: object
const_other_device_models:
description: Other-device model definitions returned by the constants API
items:
$ref: '#/components/schemas/const_other_device_model'
type: array
const_device_gateway_defaults:
additionalProperties:
description: List of interfaces names (e.g. "ge-0/0/3,ge-1/0/3")
type: string
description: Object Key is the interface type name (e.g. "lan_ports", "wan_ports", ...)
type: object
const_device_ap:
additionalProperties: false
description: AP model capability definition returned by the constants API
properties:
ap_type:
description: Internal AP platform type identifier
examples:
- jewel
type: string
band24:
$ref: '#/components/schemas/const_device_ap_band24'
description: 2.4 GHz radio capability limits for this AP model
band5:
$ref: '#/components/schemas/const_device_ap_band5'
description: 5 GHz radio capability limits for this AP model
band6:
$ref: '#/components/schemas/const_device_ap_band6'
description: 6 GHz radio capability limits for this AP model
band_24_usages:
$ref: '#/components/schemas/const_device_ap_band_24_usages'
description: Supported RF band usages for the 2.4 GHz radio on this AP model
ce_dfs_ok:
description: Whether DFS operation is allowed for this AP model under CE rules
examples:
- true
type: boolean
cisco_pace:
description: Whether the AP model supports Cisco PACE interoperability
type: boolean
description:
description: Product description for the AP model
examples:
- AP-45
type: string
disallowed_channels:
additionalProperties:
additionalProperties:
$ref: '#/components/schemas/const_device_ap_disallowed_channels'
description: Property key is the RF band (e.g. "band5")
type: object
description: Property key is a list of country codes (e.g. "GB, DE")
type: object
display:
description: User-facing model name shown for the AP
examples:
- AP45
type: string
extio:
additionalProperties:
$ref: '#/components/schemas/const_device_ap_extios'
description: Property key is the GPIO port name (e.g. "D0", "A1")
type: object
fcc_dfs_ok:
description: Whether DFS operation is allowed for this AP model under FCC rules
examples:
- true
type: boolean
has_11ax:
description: Whether the AP model supports 802.11ax
type: boolean
has_compass:
description: Whether the AP model includes a compass sensor
examples:
- false
type: boolean
has_ext_ant:
description: Whether the AP model supports external antennas
type: boolean
has_extio:
description: Whether the AP model exposes external I/O ports
examples:
- false
type: boolean
has_height:
description: Whether mounting height can be configured for this AP model
examples:
- false
type: boolean
has_module_port:
description: Whether the AP model includes a module port
type: boolean
has_poe_out:
description: Whether the AP model supports PoE output
examples:
- true
type: boolean
has_scanning_radio:
description: Whether the AP model has scanning-radio capability
examples:
- true
type: boolean
has_selectable_radio:
description: Whether the AP model has selectable radio modes
examples:
- true
type: boolean
has_usb:
description: Whether the AP model includes a USB port
type: boolean
has_vble:
description: Whether the AP model supports virtual BLE (vBLE)
examples:
- true
type: boolean
has_wifi_band24:
description: Whether the AP model supports 2.4 GHz Wi-Fi
examples:
- true
type: boolean
has_wifi_band5:
description: Whether the AP model supports 5 GHz Wi-Fi
examples:
- true
type: boolean
has_wifi_band6:
description: Whether the AP model supports 6 GHz Wi-Fi
examples:
- true
type: boolean
max_poe_out:
description: Maximum PoE-out power budget supported by the AP model, in milliwatts
examples:
- 15400
type: integer
max_wlans:
description: Maximum number of WLANs supported by this AP model
type: integer
model:
description: AP model identifier for this capability definition
examples:
- AP45
type: string
other_dfs_ok:
description: Whether DFS operation is allowed for this AP model in other regulatory domains
examples:
- true
type: boolean
outdoor:
description: Whether the AP model is rated for outdoor deployment
type: boolean
radios:
additionalProperties:
type: string
description: Property key is the radio number (e.g. r0, r1, ...). Property value is the RF band (e.g. "24", "5", ...)
examples:
- r0: '6'
r1: '5'
r2: '24'
type: object
shared_scanning_radio:
description: Whether scanning-radio capability shares a radio with client service
type: boolean
type:
$ref: '#/components/schemas/const_device_type_ap'
description: Device type for this AP model definition
unmanaged:
description: Whether this AP model is listed as unmanaged in the constants catalog
type: boolean
vble:
$ref: '#/components/schemas/const_device_ap_vble'
description: Virtual BLE (vBLE) capability settings for this AP model
required:
- ap_type
- type
type: object
const_device_gateway:
additionalProperties: false
description: Gateway model capability definition returned by the constants API
properties:
defaults:
$ref: '#/components/schemas/const_device_gateway_defaults'
description: Default interface group mappings for this gateway model
description:
description: Product description for the gateway model
type: string
experimental:
default: false
description: Whether this gateway model is marked experimental in the constants catalog
type: boolean
fans_pluggable:
default: true
description: Whether the gateway model has field-replaceable fans
type: boolean
ha_node0_fpc:
description: FPC number used for node0 in HA deployments
type: integer
ha_node1_fpc:
description: FPC number used for node1 in HA deployments
type: integer
has_bgp:
default: false
description: Whether the gateway model supports BGP
type: boolean
has_fxp0:
default: true
description: Whether the gateway model includes an fxp0 management interface
type: boolean
has_ha_control:
default: false
description: Whether the gateway model has a dedicated HA control port
type: boolean
has_ha_data:
default: false
description: Whether the gateway model has dedicated HA data ports
type: boolean
has_irb:
default: false
description: Whether the gateway model supports IRB interfaces
type: boolean
has_poe_out:
default: true
description: Whether the gateway model supports PoE output
type: boolean
has_snapshot:
default: true
description: Whether the gateway model supports configuration snapshots
type: boolean
irb_disabled_by_default:
default: false
description: Whether IRB interfaces are disabled by default on this gateway model
type: boolean
model:
description: Gateway model identifier for this capability definition
type: string
number_fans:
description: Number of fans in the gateway model
type: integer
oc_device:
default: false
description: Whether this gateway model is identified as an OpenConfig-managed device
type: boolean
pic:
$ref: '#/components/schemas/const_device_gateway_pic'
description: Physical Interface Card port layout for this gateway model
ports:
$ref: '#/components/schemas/const_device_gateway_ports'
description: Per-interface metadata for this gateway model
sub_required:
description: Subscription type required for this gateway model
type: string
t128_device:
default: false
description: Whether this gateway model is a 128 Technology or SSR device
type: boolean
type:
$ref: '#/components/schemas/const_device_type_gateway'
description: Device type for this gateway model definition
required:
- type
type: object
const_device_switch_default:
additionalProperties: false
description: Default switch port ranges for a model
properties:
_ports:
description: Default switch port range list for this model
examples:
- ge-0/0/0-47, et-0/1/0-3, xe-0/2/0-3, ge-0/2/0-3
type: string
type: object
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
const_device_type_switch:
description: 'Device Type. enum: `switch`'
enum:
- switch
readOnly: true
type: string
const_mxedge_models:
description: Mist Edge model definitions returned by the constants API
items:
$ref: '#/components/schemas/const_mxedge_model'
type: array
response_http403:
additionalProperties: false
description: Standard HTTP 403 permission error response
properties:
detail:
description: Human-readable explanation of the permission error
examples:
- You do not have permission to perform this action.
type: string
type: object
const_device_gateway_ports:
additionalProperties: false
description: Object Key is the interface name (e.g. "ge-0/0/1", ...)
properties:
display:
description: User-facing interface name for the gateway port
type: string
pci_address:
description: PCI address for the gateway port
type: string
speed:
description: Port speed for the gateway interface, in Mbps
type: integer
type: object
const_mxedge_model_port:
additionalProperties: false
description: Mist Edge model port metadata
properties:
display:
description: User-facing interface name for this Mist Edge port
examples:
- xe0
type: string
speed:
description: Port speed for the Mist Edge interface, in Mbps
examples:
- 10000
type: integer
type: object
const_device_model:
description: Device model definition returned by the constants API
discriminator:
mapping:
ap: '#/components/schemas/const_device_ap'
gateway: '#/components/schemas/const_device_switch'
switch: '#/components/schemas/const_device_gateway'
propertyName: type
oneOf:
- $ref: '#/components/schemas/const_device_ap'
- $ref: '#/components/schemas/const_device_switch'
- $ref: '#/components/schemas/const_device_gateway'
const_device_ap_band5:
additionalProperties: false
description: 5 GHz radio capability limits for an AP model
properties:
max_clients:
description: Maximum client count supported on the 5 GHz radio
examples:
- 128
type: integer
max_power:
description: Maximum transmit power for the 5 GHz radio, in dBm
examples:
- 17
type: integer
min_power:
description: Minimum transmit power for the 5 GHz radio, in dBm
examples:
- 8
type: integer
type: object
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
const_device_gateway_pic:
additionalProperties:
description: List of type and number of ports (e.g. "mge*8, ge*16")
type: string
description: Object Key is the PIC number
type: object
const_device_models:
description: Device model definitions returned by the constants API
items:
$ref: '#/components/schemas/const_device_model'
type: array
const_device_ap_band_24_usages:
description: Supported 2.4 GHz radio usage modes for AP models
items:
$ref: '#/components/schemas/const_device_ap_band_24_usage'
type: array
const_device_ap_band24:
additionalProperties: false
description: 2.4 GHz radio capability limits for an AP model
properties:
band5_channels_op:
description: 5 GHz channel set used when this radio operates on 5 GHz
examples:
- low
type: string
max_clients:
description: Maximum client count supported on the 2.4 GHz radio
examples:
- 128
type: integer
max_power:
description: Maximum transmit power for the 2.4 GHz radio, in dBm
examples:
- 19
type: integer
min_power:
description: Minimum transmit power for the 2.4 GHz radio, in dBm
examples:
- 8
type: integer
type: object
const_other_device_model:
additionalProperties: false
description: Other-device model definition returned by the constants API
properties:
_vendor_model_id:
description: Vendor-specific model identifier for this other-device model
type: string
display:
description: User-facing model name shown for the other-device model
type: string
model:
description: Device model identifier for this other-device definition
type: string
type:
description: Device category for this other-device model
type: string
vendor:
description: Manufacturer name for this other-device model
type: string
type: object
const_device_ap_extios_default_dir:
description: 'Default direction for this external I/O port. enum: `IN`, `OUT`'
enum:
- IN
- OUT
type: string
const_device_type_ap:
description: 'Device Type. enum: `ap`'
enum:
- ap
readOnly: true
type: string
const_mxedge_model:
additionalProperties: false
description: Mist Edge model definition returned by the constants API
properties:
custom_ports:
description: Whether this Mist Edge model supports custom port definitions
type: boolean
display:
description: User-facing model name shown for the Mist Edge
examples:
- X10
type: string
model:
description: Mist Edge model identifier
examples:
- ME-X10
type: string
ports:
additionalProperties:
$ref: '#/components/schemas/const_mxedge_model_port'
description: Port metadata keyed by interface number for this Mist Edge model
type: object
type: object
const_device_ap_band_24_usage:
description: 'enum: `24`, `5`, `6`'
enum:
- '24'
- '5'
- '6'
type: string
const_device_ap_extios:
additionalProperties: false
description: External I/O port capabilities for an AP model
properties:
default_dir:
$ref: '#/components/schemas/const_device_ap_extios_default_dir'
description: Default direction for this external I/O port
input:
description: Whether this external I/O port supports input mode
type: boolean
output:
description: Whether this external I/O port supports output mode
type: boolean
type: object
const_device_ap_disallowed_channels:
description: Disallowed RF channel definitions for AP device models
items:
type: integer
type: array
const_device_ap_vble:
additionalProperties: false
description: Virtual BLE (vBLE) capability settings for an AP model
properties:
beacon_rate:
description: Advertisement rate for the virtual BLE beacon
examples:
- 4
type: integer
beams:
description: Number of virtual BLE beams supported by the AP model
examples:
- 9
type: integer
power:
description: Transmit power for virtual BLE beacons, in dBm
examples:
- 8
type: integer
type: object
const_device_type_gateway:
description: 'Device Type. enum: `gateway`'
enum:
- gateway
readOnly: true
type: string
const_device_ap_band6:
additionalProperties: false
description: 6 GHz radio capability limits for an AP model
properties:
max_clients:
description: Maximum client count supported on the 6 GHz radio
examples:
- 128
type: integer
max_power:
description: Maximum transmit power for the 6 GHz radio, in dBm
examples:
- 17
type: integer
min_power:
description: Minimum transmit power for the 6 GHz radio, in dBm
examples:
- 8
type: integer
type: object
response_http404:
additionalProperties: false
description: Standard HTTP 404 not found error response
properties:
id:
description: Missing resource identifier, when the API includes one
type: string
type: object
responses:
ConstOtherDeviceModels:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstOtherDeviceModelsExample'
schema:
$ref: '#/components/schemas/const_other_device_models'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstOtherDeviceModelsExample'
schema:
$ref: '#/components/schemas/const_other_device_models'
description: OK
HTTP400:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/HTTP400Example'
schema:
$ref: '#/components/schemas/response_http400'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/HTTP400Example'
schema:
$ref: '#/components/schemas/response_http400'
description: Bad Syntax
HTTP403:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/HTTP403Example'
schema:
$ref: '#/components/schemas/response_http403'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/HTTP403Example'
schema:
$ref: '#/components/schemas/response_http403'
description: Permission Denied
ConstMxEdgeModels:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/ConstMxEdgeModelsExample'
schema:
$ref: '#/components/schemas/const_mxedge_models'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/ConstMxEdgeModelsExample'
schema:
$ref: '#/components/schemas/const_mxedge_models'
description: List of MxEdge Models
ConstDeviceModels:
content:
application/json:
examples:
AP:
$ref: '#/components/examples/ConstDeviceModelsAP'
Gateway:
$ref: '#/components/examples/ConstDeviceModelsGateway'
Switch:
$ref: '#/components/examples/ConstDeviceModelsSwitch'
schema:
$ref: '#/components/schemas/const_device_models'
application/vnd.api+json:
examples:
AP:
$ref: '#/components/examples/ConstDeviceModelsAP'
Gateway:
$ref: '#/components/examples/ConstDeviceModelsGateway'
Switch:
$ref: '#/components/examples/ConstDeviceModelsSwitch'
schema:
# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mist/refs/heads/main/openapi/mist-constants-models-api-openapi.yml