Mist Constants Definitions API
API Calls to retrieve constant values that can be used in different parts of the configuration
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 Definitions 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 constant values that can be used in different parts of the configuration
name: Constants Definitions
paths:
/api/v1/const/ap_channels:
get:
description: Return supported AP radio channels for the requested country code, based on the regulatory domain used by Mist AP configuration.
operationId: listApChannels
parameters:
- $ref: '#/components/parameters/country_code'
responses:
'200':
$ref: '#/components/responses/ConstApChannels'
'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: listApChannels
tags:
- Constants Definitions
/api/v1/const/ap_esl_versions:
get:
description: Return Electronic Shelf Label (ESL) firmware versions available per AP model.
operationId: listApLEslVersions
responses:
'200':
$ref: '#/components/responses/ConstApEslVersions'
'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: listApLEslVersions
tags:
- Constants Definitions
/api/v1/const/ap_led_status:
get:
description: Return AP LED status definitions, including the values used to describe LED behavior and the corresponding `error_code` value.
operationId: listApLedDefinition
responses:
'200':
$ref: '#/components/responses/ConstApLedDefinitions'
'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: listApLedDefinition
tags:
- Constants Definitions
/api/v1/const/app_categories:
get:
description: Return supported application categories used for application identification, traffic classification, and policy matching.
operationId: listAppCategoryDefinitions
responses:
'200':
$ref: '#/components/responses/ConstAppCategoryDefinitions'
'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: listAppCategoryDefinitions
tags:
- Constants Definitions
/api/v1/const/app_subcategories:
get:
description: Return supported application subcategories used for application identification, traffic classification, and policy matching.
operationId: listAppSubCategoryDefinitions
responses:
'200':
$ref: '#/components/responses/ConstAppSubCategoryDefinitions'
'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: listAppSubCategoryDefinitions
tags:
- Constants Definitions
/api/v1/const/applications:
get:
description: Return applications recognized by Juniper Mist devices for traffic classification and application analytics.
operationId: listApplications
responses:
'200':
$ref: '#/components/responses/ConstApplications'
'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: listApplications
tags:
- Constants Definitions
/api/v1/const/countries:
get:
description: Return supported country codes for Mist configuration. Set `extend=true` to include additional country codes when available.
operationId: listCountryCodes
parameters:
- description: Will include more country codes if true
in: query
name: extend
schema:
default: false
type: boolean
responses:
'200':
$ref: '#/components/responses/ConstCountries'
'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: listCountryCodes
tags:
- Constants Definitions
/api/v1/const/fingerprint_types:
get:
description: Return supported client fingerprint attribute values (`family`, `model`, `mfg`, and `os_type`) that can be used in [Mist NAC Rules]($h/Orgs%20NAC%20Rules/_overview) `matching` conditions.
operationId: listFingerprintTypes
responses:
'200':
$ref: '#/components/responses/ConstFingerprintTypes'
'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: listFingerprintTypes
tags:
- Constants Definitions
/api/v1/const/gateway_applications:
get:
description: Return applications recognized by Mist gateways for traffic classification.
operationId: listGatewayApplications
responses:
'200':
$ref: '#/components/responses/ConstGatewayApplications'
'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: listGatewayApplications
tags:
- Constants Definitions
/api/v1/const/insight_metrics:
get:
description: Return supported insight metric names and metadata used by insight and SLE APIs.
operationId: listInsightMetrics
responses:
'200':
$ref: '#/components/responses/ConstInsightMetrics'
'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: listInsightMetrics
tags:
- Constants Definitions
/api/v1/const/languages:
get:
description: Return supported language codes for localized Mist configuration and user-facing portals.
operationId: listSiteLanguages
responses:
'200':
$ref: '#/components/responses/ConstLanguages'
'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: listSiteLanguages
tags:
- Constants Definitions
/api/v1/const/license_types:
get:
description: Return Mist license type definitions used by inventory and subscription APIs.
operationId: listLicenseTypes
responses:
'200':
$ref: '#/components/responses/ConstLicenseTypes'
'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: listLicenseTypes
tags:
- Constants Definitions
/api/v1/const/marvisclient_versions:
get:
description: Return available Marvis Client application versions for tracking or managing Marvis Client deployments.
operationId: listMarvisClientVersions
responses:
'200':
$ref: '#/components/responses/ConstMarvisClientVersions'
'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: listMarvisClientVersions
tags:
- Constants Definitions
/api/v1/const/states:
get:
description: Return ISO state or province codes for the supplied country code.
operationId: listStates
parameters:
- description: Country code, in [two-character](/#operations/listCountryCodes)
in: query
name: country_code
required: true
schema:
examples:
- US
type: string
responses:
'200':
$ref: '#/components/responses/ConstStates'
'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: listStates
tags:
- Constants Definitions
/api/v1/const/traffic_types:
get:
description: Return traffic type definitions used to classify recognized network traffic.
operationId: listTrafficTypes
responses:
'200':
$ref: '#/components/responses/ConstTrafficTypes'
'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: listTrafficTypes
tags:
- Constants Definitions
/api/v1/const/webhook_topics:
get:
description: Return webhook topic definitions that can be subscribed to in webhook configuration.
operationId: listWebhookTopics
responses:
'200':
$ref: '#/components/responses/ConstWebhookTopics'
'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: listWebhookTopics
tags:
- Constants Definitions
components:
schemas:
const_insight_metrics_property_examples:
description: List of example values for an insight metric property
items:
$ref: '#/components/schemas/const_insight_metrics_property_example'
type: array
const_insight_metrics_property_param:
additionalProperties: false
description: Query parameter definition for an insight metric
properties:
required:
description: Whether this query parameter is required
type: boolean
type: object
const_language:
additionalProperties: false
description: Language option returned by the constants API
properties:
display:
description: Localized language display name in the API default locale
examples:
- English (US)
type: string
display_native:
description: Language display name in its native locale
examples:
- English (US)
type: string
key:
description: Locale key used to select this language
examples:
- en-US
type: string
required:
- display
- display_native
- key
type: object
const_insight_metrics_property_report_duration:
additionalProperties: false
description: Report duration definition for an insight metric
properties:
duration:
description: Report duration length, in seconds
type: integer
interval:
description: Sampling interval used for this report duration, in seconds
type: integer
type: object
ap_channel_band6_channels:
additionalProperties:
$ref: '#/components/schemas/ap_channel_band6_channel'
description: Property key is the channel width
examples:
- '160':
- 1
- 5
- 9
- 13
- 17
- 21
- 25
- 29
- 33
- 37
- 41
- 45
- 49
- 53
- 57
- 61
- 65
- 69
- 73
- 77
- 81
- 85
- 89
- 93
- 97
- 101
- 105
- 109
- 113
- 117
- 121
- 125
- 129
- 133
- 137
- 141
- 145
- 149
- 153
- 157
- 161
- 165
- 169
- 173
- 177
- 181
- 185
- 189
- 193
- 197
- 201
- 205
- 209
- 213
- 217
- 221
'20':
- 1
- 5
- 9
- 13
- 17
- 21
- 25
- 29
- 33
- 37
- 41
- 45
- 49
- 53
- 57
- 61
- 65
- 69
- 73
- 77
- 81
- 85
- 89
- 93
- 97
- 101
- 105
- 109
- 113
- 117
- 121
- 125
- 129
- 133
- 137
- 141
- 145
- 149
- 153
- 157
- 161
- 165
- 169
- 173
- 177
- 181
- 185
- 189
- 193
- 197
- 201
- 205
- 209
- 213
- 217
- 221
- 225
- 229
- 233
'40':
- 1
- 5
- 9
- 13
- 17
- 21
- 25
- 29
- 33
- 37
- 41
- 45
- 49
- 53
- 57
- 61
- 65
- 69
- 73
- 77
- 81
- 85
- 89
- 93
- 97
- 101
- 105
- 109
- 113
- 117
- 121
- 125
- 129
- 133
- 137
- 141
- 145
- 149
- 153
- 157
- 161
- 165
- 169
- 173
- 177
- 181
- 185
- 189
- 193
- 197
- 201
- 205
- 209
- 213
- 217
- 221
- 225
- 229
'80':
- 1
- 5
- 9
- 13
- 17
- 21
- 25
- 29
- 33
- 37
- 41
- 45
- 49
- 53
- 57
- 61
- 65
- 69
- 73
- 77
- 81
- 85
- 89
- 93
- 97
- 101
- 105
- 109
- 113
- 117
- 121
- 125
- 129
- 133
- 137
- 141
- 145
- 149
- 153
- 157
- 161
- 165
- 169
- 173
- 177
- 181
- 185
- 189
- 193
- 197
- 201
- 205
- 209
- 213
- 217
- 221
psc:
- 5
- 21
- 37
- 53
- 69
- 85
- 101
- 117
- 133
- 149
- 165
- 181
- 197
- 213
- 229
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_traffic_type:
additionalProperties: false
description: Traffic type definition returned by the constants API
properties:
display:
description: Human-readable traffic type label
examples:
- VoIP Video
type: string
dscp:
description: Differentiated Services Code Point value used for this traffic type
examples:
- 32
type: integer
failover_policy:
description: Failover behavior associated with this traffic type
examples:
- non_revertible
type: string
max_jitter:
description: Maximum jitter threshold for this traffic type, in milliseconds
examples:
- 250
type: integer
max_latency:
description: Maximum latency threshold for this traffic type, in milliseconds
examples:
- 1500
type: integer
max_loss:
description: Maximum packet loss threshold for this traffic type, in percent
examples:
- 35
type: integer
name:
description: Machine-readable traffic type name
examples:
- voip_video
type: string
traffic_class:
description: Traffic class associated with this traffic type
examples:
- medium
type: string
type: object
const_license_type:
additionalProperties: false
description: License type definition returned by the constants API
properties:
description:
description: Human-readable description of the license type
examples:
- Wired Assurance 12
type: string
includes:
$ref: '#/components/schemas/const_license_type_includes'
description: License SKU components included by this license type
key:
description: Machine-readable license type key
examples:
- sub_ex12
type: string
name:
description: Display name of the license type
examples:
- SUB-EX12
type: string
type: object
const_fingerprint_types:
additionalProperties: false
description: Supported client fingerprint values for NAC matching
properties:
family:
$ref: '#/components/schemas/strings'
description: Device family values available for client fingerprint matching
mfg:
$ref: '#/components/schemas/strings'
description: Manufacturer values available for client fingerprint matching
model:
$ref: '#/components/schemas/strings'
description: Device model values available for client fingerprint matching
os:
$ref: '#/components/schemas/strings'
description: Operating system values available for client fingerprint matching
type: object
const_languages:
description: Language options returned by the constants API
items:
$ref: '#/components/schemas/const_language'
type: array
const_insight_metrics_property_example:
anyOf:
- type: integer
- type: number
- type: string
- type: boolean
- type: 'null'
- additionalProperties: true
type: object
description: Example value for an insight metric property
const_app_subcategory_definitions:
description: Application subcategory definitions returned by the constants API
items:
$ref: '#/components/schemas/const_app_subcategory_definition'
type: array
const_states:
description: State and territory definitions returned by the constants API
items:
$ref: '#/components/schemas/const_state'
type: array
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_insight_metrics_property_intervals:
additionalProperties:
$ref: '#/components/schemas/const_insight_metrics_property_interval'
description: Property key is the interval (e.g. 10m, 1h, ...)
type: object
const_app_subcategory_definition:
additionalProperties: false
description: Application subcategory definition returned by the constants API
properties:
display:
description: Description of the app subcategory
examples:
- Office Document
type: string
key:
description: Machine-readable application subcategory key
examples:
- Office_Documents
type: string
traffic_type:
description: Type of traffic (QoS) of the app subcategory
examples:
- Images
type: string
required:
- key
- display
- traffic_type
type: object
ap_channel_band6_channel:
description: Supported 6 GHz channel numbers for a channel-width group
items:
examples:
- 1
type: integer
type: array
const_insight_metrics_property_interval:
additionalProperties: false
description: Interval definition for an insight metric
properties:
interval:
description: Sampling interval length, in seconds
type: integer
max_age:
description: Maximum lookback age for this interval, in seconds
type: integer
type: object
const_license_types:
description: License type definitions returned by the constants API
items:
$ref: '#/components/schemas/const_license_type'
type: array
ap_channel_band24_channels:
additionalProperties:
$ref: '#/components/schemas/ap_channel_band24_channel'
description: Property key is the channel width
examples:
- '20':
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
'40':
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
type: object
const_marvis_client_version:
additionalProperties: false
description: Marvis Client version download entry
properties:
label:
description: Release label for this Marvis Client version
examples:
- default
type: string
notes:
description: Release notes or extra text for this Marvis Client version
type: string
os:
description: Operating system supported by this Marvis Client installer
examples:
- windows
type: string
url:
description: Download URL for this Marvis Client installer
examples:
- https://mobile.mist.com/installers/marvisclient/...
type: string
version:
description: Marvis Client software version for this installer
examples:
- 0.100.29
type: string
type: object
const_app_category_definition_filters:
additionalProperties: false
description: Platform-specific application category filters
examples:
- srx:
- Enhanced_Images_Media
- Enhanced_Web_Images
- Enhanced_Image_Servers
properties:
srx:
$ref: '#/components/schemas/strings'
description: Application signature names for SRX platforms included in this category
ssr:
$ref: '#/components/schemas/strings'
description: Application identifiers for SSR platforms included in this category
type: object
const_insight_metrics_property_values:
additionalProperties: true
description: Enumerated or structured value metadata for an insight metric property
type: object
const_country:
additionalProperties: false
description: Country definition returned by the constants API
properties:
alpha2:
description: Country code, in two-character
examples:
- FR
type: string
certified:
description: Whether this country is certified for use in Mist APs
examples:
- true
type: boolean
name:
description: Human-readable country name for display
examples:
- France
type: string
numeric:
description: Country code, ISO 3166-1 numeric
examples:
- 250
type: number
required:
- alpha2
- numeric
- name
- certified
type: object
const_application_definitions:
description: Application definitions returned by the constants API
items:
$ref: '#/components/schemas/const_application_definition'
type: array
const_insight_metrics_property_examples_object:
additionalProperties:
$ref: '#/components/schemas/const_insight_metrics_property_examples'
description: Object containing named fields, each with array of example values
type: object
const_insight_metrics_property_keys:
additionalProperties: true
description: Additional key metadata for an insight metric property
type: object
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_insight_metrics_property_example_any_of:
anyOf:
- $ref: '#/components/schemas/const_insight_metrics_property_examples'
- $ref: '#/components/schemas/const_insight_metrics_property_examples_object'
description: Example values for an insight metric property, as an array or keyed object
const_ap_leds:
description: AP LED status and trouble-code definitions returned by the constants API
items:
$ref: '#/components/schemas/const_ap_led'
type: array
const_license_type_includes:
description: License SKU components included by a license type
examples:
- - sub_ex12a
- sub_ex12p
items:
type: string
type: array
const_ap_esl_version:
additionalProperties: false
description: Supported Electronic Shelf Label (ESL) version for an AP model
properties:
esl_version:
description: Electronic Shelf Label (ESL) package version supported by the AP model
examples:
- 2.5.1
readOnly: true
type: string
model:
description: AP model that supports the listed ESL version
examples:
- AP34
readOnly: true
type: string
type: object
const_traffic_types:
description: Traffic type definitions returned by the constants API
items:
$ref: '#/components/schemas/const_traffic_type'
type: array
const_app_category_definition_includes:
description: List of other App Categories contained by this one
items:
type: string
type: array
const_insight_metrics_property_scopes:
description: Entity scopes supported by an insight metric property
items:
$ref: '#/components/schemas/const_insight_metrics_property_scope'
type: array
const_countries:
description: Country definitions returned by the constants API
items:
$ref: '#/components/schemas/const_country'
type: array
const_webhook_topics:
description: Webhook topic definitions returned by the constants API
items:
$ref: '#/components/schemas/const_webhook_topic'
type: array
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
const_insight_metrics_property_scope:
description: 'enum: `
# --- truncated at 32 KB (70 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mist/refs/heads/main/openapi/mist-constants-definitions-api-openapi.yml