Cisco Meraki Service Graph Connector API Endpoints

  • Release version: Australia
  • Updated July 20, 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 data from the Cisco Meraki Dashboard API into the ServiceNow AI Platform® Configuration Management Database (CMDB). This integration enables ServiceNow customers to import detailed organizational, network, device, and status information directly into their CMDB for enhanced visibility and management of their Meraki infrastructure.

    Show full answer Show less

    Key API Endpoints and Their Functions

    • Organizations Endpoint: Retrieves organizational details including the organization ID, name, and management information such as MSP ID and API IP restriction modes.
    • Networks Endpoint: Provides network-level information within an organization, including network ID, name, and descriptive notes.
    • Devices Endpoint: Returns detailed device data such as serial number, device name, associated network ID, model, MAC address, product type, firmware version, geographic location, and notes.
    • Device Statuses Endpoint: Supplies real-time device status including online state, public IP, WAN interfaces IP addresses, gateway, and DNS information.
    • Uplink Statuses Endpoint: Delivers uplink interface statuses for devices, including details on high availability roles, interface status, IP configuration, gateway, DNS, and cellular connectivity parameters.
    • Switch Ports Endpoint: Reports status of switch ports by device serial number and network, indicating which ports are connected or disconnected.
    • Device Inventory Endpoint: Offers inventory-specific data such as device serial, order number, and license expiration date.

    Practical Benefits for ServiceNow Customers

    By leveraging these API endpoints, ServiceNow customers can:

    • Automatically synchronize Meraki organizational and network structures into the CMDB.
    • Maintain up-to-date device inventories including hardware details and licensing.
    • Monitor device statuses and uplink conditions in near real-time to support proactive network management.
    • Track switch port connectivity to assist in network troubleshooting and capacity planning.
    • Use integrated Meraki data to enhance IT service management, asset management, and operational decision-making within ServiceNow.

    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"                              │
│  }