Cisco Meraki Service Graph Connector API Endpoints

  • Release version: Australia
  • Updated June 16, 2026
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Cisco Meraki Service Graph Connector API Endpoints

    The Cisco Meraki Service Graph Connector integrates Cisco Meraki Dashboard API data directly into the ServiceNow AI Platform® Configuration Management Database (CMDB). This enables ServiceNow customers to automate and streamline the synchronization of network and device information from Meraki into their CMDB, supporting enhanced visibility and management of network assets within ServiceNow.

    Show full answer Show less

    API Endpoints and Their Functions

    • Organizations Endpoint: Retrieves details about Meraki organizations, including organization ID, name, and management information such as MSP ID and API IP restrictions.
    • Networks Endpoint: Lists networks within a specified organization, providing network IDs, names, and descriptions.
    • Devices Endpoint: Returns device details including serial number, device name, network association, model, MAC address, product type, firmware version, geographic location, address, and notes.
    • Device Statuses Endpoint: Provides real-time status information for devices such as online/offline status, public IP, WAN IPs, gateway, and DNS configuration.
    • Uplink Statuses Endpoint: Details uplink interfaces on devices, their status (active, ready), IP information, gateway, DNS, high availability roles, and cellular connection data where applicable.
    • Switch Ports Endpoint: Reports the status of switch ports by switch serial number, including port IDs and whether each port is connected or disconnected.
    • Device Inventory Endpoint: Supplies inventory-related information for devices, including order numbers and license expiration dates.

    Practical Value for ServiceNow Customers

    By leveraging these API endpoints, ServiceNow customers can expect to:

    • Maintain an up-to-date, accurate CMDB reflecting Meraki network infrastructure and device status.
    • Gain visibility into network health and device connectivity.
    • Track device inventory and licensing details to support asset management and compliance.
    • Enable automated workflows and incident resolution based on real-time network data.

    Overall, these endpoints empower ServiceNow users to integrate and operationalize Cisco Meraki network data efficiently within their ServiceNow environment.

    The Service Graph Connector for Meraki integrates Cisco Meraki Dashboard API data into ServiceNow AI Platform®Configuration Management Database (CMDB). This document details the API endpoints used and how data flows through the system.

    Table 1. Organizations endpoint
    Description API response
    Organizations API response

    URL:/organizations

    		 
    {                                                                    │
│    "id": "123456",                                                    │
│    "name": "My Organization",                                         │
│    "management": {                                                    │
│      "details": {                                                     │
│        "MSP ID": "...",                                               │
│        "customer number": "...",                                      │
│        "IP restriction mode for API": "..."                           │
│      }                                                                │
│    }                                                                  │
│  }
    Table 2. Networks Endpoint
    Description Endpoint
    Networks API response

    URL:/organizations/{orgId}/networks

    		 
    {                                                                    │
│    "id": "N_123456",                                                  │
│    "organizationId": "123456",                                        │
│    "name": "My Network",                                              │
│    "notes": "Network description"                                     │
│  }
    Table 3. Devices Endpoint
    Description Endpoint
    Devices API response

    URL: /organizations/{orgId}/devices

    		 
    {                                                                    │
│    "serial": "Q2XX-XXXX-XXXX",                                        │
│    "name": "My Device",                                               │
│    "networkId": "N_123456",                                           │
│    "model": "MX68",                                                   │
│    "mac": "00:11:22:33:44:55",                                        │
│    "productType": "appliance",                                        │
│    "firmware": "mx-18.1",                                             │
│    "lat": 37.7749,                                                    │
│    "lng": -122.4194,                                                  │
│    "address": "123 Main St",                                          │
│    "notes": "Device description"                                      │
│  }
    Table 4. Device statuses endpoint
    Description Endpoint
    Devices statuses API response

    URL: /organizations/{orgId}/devices/statuses

    		 
    {                                                                    │
│    "serial": "Q2XX-XXXX-XXXX",                                        │
│    "status": "online",                                                │
│    "publicIp": "203.0.113.1",                                         │
│    "wan1Ip": "192.168.1.1",                                           │
│    "wan2Ip": "192.168.2.1",                                           │
│    "wan1Gateway": "192.168.1.254",                                    │
│    "wan1IpType": "dhcp",                                              │
│    "wan1PrimaryDns": "8.8.8.8",                                       │
│    "wan1SecondaryDns": "8.8.4.4"                                      │
│  }
    Table 5. Uplink statuses endpoint
    Description Endpoint
    Uplink statuses endpoint

    URL: /organizations/{orgId}/uplinks/statuses

    		 
    {                                                                    │
│    "serial": "Q2XX-XXXX-XXXX",                                        │
│    "networkId": "N_123456",                                           │
│    "model": "MX68",                                                   │
│    "highAvailability": {                                              │
│      "enabled": true,                                                 │
│      "role": "primary"                                                │
│    },                                                                 │
│    "uplinks": [                                                       │
│      {                                                                │
│        "interface": "wan1",                                           │
│        "status": "active",                                            │
│        "ip": "192.168.1.1",                                           │
│        "gateway": "192.168.1.254",                                    │
│        "publicIp": "203.0.113.1",                                     │
│        "primaryDns": "8.8.8.8",                                       │
│        "secondaryDns": "8.8.4.4",                                     │
│        "ipAssignedBy": "dhcp"                                         │
│      },                                                               │
│      {                                                                │
│        "interface": "cellular",                                       │
│        "status": "ready",                                             │
│        "apn": "broadband",                                            │
│        "iccid": "...",                                                │
│        "imsi": "...",                                                 │
│        "msisdn": "..."                                                │
│      }                                                                │
│    ]                                                                  │
│  }
    Table 6. Switch ports endpoint
    Description Endpoint
    Switch ports endpoint

    URL: /organizations/{orgId}/switch/ports/statuses/bySwitch

    		 
    {                                                                    │
│    "items": [                                                         │
│      {                                                                │
│        "serial": "Q2XX-XXXX-XXXX",                                    │
│        "network": { "id": "N_123456" },                               │
│        "ports": [                                                     │
│          {                                                            │
│            "portId": "1",                                             │
│            "status": "connected"                                      │
│          },                                                           │
│          {                                                            │
│            "portId": "2",                                             │
│            "status": "disconnected"                                   │
│          }                                                            │
│        ]                                                              │
│      }                                                                │
│    ]                                                                  │
│  }
    Table 7. Device inventory endpoint
    Description Endpoint
    Device inventory endpoint

    URL: /organizations/{orgId}/inventory/devices

    		 
     {                                                                    │
│    "serial": "Q2XX-XXXX-XXXX",                                        │
│    "orderNumber": "ORD-12345",                                        │
│    "licenseExpirationDate": "2025-12-31"                              │
│  }