Support Support Downloads Knowledge Base Juniper Support Portal Community

Knowledge Base

Search our Knowledge Base sites to find answers to your questions.

Ask All Knowledge Base Sites All Knowledge Base Sites JunosE Defect (KA)Knowledge BaseSecurity AdvisoriesTechnical BulletinsTechnotes Sign in to display secure content and recently viewed articles

[CSO] How to use POSTMAN API to check operational or monitored status of a spoke site



Article ID: KB37457 KB Last Updated: 24 Sep 2021Version: 1.0

This article explains how to query a CSO DB to obtain the operational status of a site. This is an alternative way to get the operational status other than relying on CSO UI.

  1. Get the authentication token for the site that needs to be used in POSTMAN to send GET request. Refer to KB36299 - Getting CSO AUTH token using development tools in the browser.

  2. Get the site UUID with the following API:

    <output snip>
    "fq_name": [
                "uuid": "ba86dd1c-6e68-4219-9205-407c30371363",
  3. Use site UUID shown above in the following POST query to get the operational status:

      "POST" https://<CSO-IP>/topology-service/get-device-status
    <post body>
        "input": {
            "uuids": [
                "UUID of site "

    Output of the POST query:

        "output": {
            "status": "success",
            "device_status": [
                    "monitored_state": "down",
                    "fq_name_str": "domain:tenant:device",
                    "uuid": "site uuid"

    The output above shows the device monitored status is down, which is reflected in the operational status in CSO UI.

Comment on this article > Affected Products Browse the Knowledge Base for more articles related to these product categories. Select a category to begin.

Getting Up and Running with Junos

Getting Up and Running with Junos Security Alerts and Vulnerabilities Product Alerts and Software Release Notices Problem Report (PR) Search Tool EOL Notices and Bulletins JTAC User Guide Customer Care User Guide Pathfinder SRX High Availability Configurator SRX VPN Configurator Training Courses and Videos End User Licence Agreement Global Search