Cisco Meraki Service Graph Connector API Endpoints

  • Release version: Australia
  • Updated August 11, 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 leverages multiple API endpoints to collect detailed organizational, network, device, and status information, enabling ServiceNow customers to maintain an accurate and up-to-date CMDB with Meraki infrastructure details.

    Show full answer Show less

    Key API Endpoints and Their Functions

    • Organizations Endpoint: Retrieves organization details such as organization ID, name, MSP ID, customer number, and API IP restriction mode. This forms the foundational organizational context.
    • Licenses Overview Endpoint: Used specifically for organizations with a CO-TERM licensing model to obtain license expiration dates at the organization level, since this data is not available per device.
    • Networks Endpoint: Provides information about networks within an organization, including network ID, name, and descriptive notes, facilitating network-level visibility.
    • Traffic Shaping Endpoints: Include uplink selection and uplink bandwidth APIs used to disable certain network-level calls to optimize API rate limits, especially for large customers.
    • Devices Endpoint: Returns comprehensive device details such as serial number, name, network association, model, MAC address, firmware version, geolocation, address, and descriptive notes, supporting detailed device inventory management.
    • Device Statuses Endpoint: Provides current device operational status and networking IP details, including public IP, WAN IPs, gateways, and DNS settings, contributing to real-time device health monitoring.
    • Uplink Statuses Endpoint: Delivers detailed uplink interface status and configuration per device, including high availability settings, IP addresses, DNS, and cellular interface specifics.
    • Switch Ports Endpoint: Reports on switch port statuses by switch serial number and network ID, indicating which ports are connected or disconnected to aid in network topology and troubleshooting.
    • Device Inventory Endpoint: Supplies additional inventory details such as order number and license expiration date per device, which is critical for asset lifecycle and compliance management.

    Benefits for ServiceNow Customers

    • Comprehensive CMDB Enrichment: Enables automated, detailed ingestion of Meraki organizational, network, device, and status data into ServiceNow CMDB, improving accuracy and operational insight.
    • Efficient Data Retrieval: Supports intelligent API call management to reduce load and adhere to Meraki API rate limits, beneficial for large-scale deployments.
    • Improved Asset and License Management: Provides visibility into device licensing and inventory details, aiding compliance and renewal planning.
    • Enhanced Network and Device Monitoring: Real-time status and uplink information support proactive incident management and network troubleshooting within ServiceNow workflows.

    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. Licenses overview endpoint
    Description API response
    Licenses overview API response

    URL: /organizations/{orgId}/licenses/overview

    Called for organizations with a CO-TERM licensing model (org.licensing.model === "co-term") to collect the license expiration date, which is not available on a per-device basis for these organizations.
    Table 3. Networks Endpoint
    Description Endpoint
    Networks API response

    URL:/organizations/{orgId}/networks

    		 
    {                                                                    │
│    "id": "N_123456",                                                  │
│    "organizationId": "123456",                                        │
│    "name": "My Network",                                              │
│    "notes": "Network description"                                     │
│  }
    Table 4. Traffic shaping endpointsUsed to disable network-level API calls that are not required for large customer organizations, to reduce the number of requests against the Meraki API rate limit.
    Description Endpoint
    Uplink selection endpoint

    URL: /networks/{networkId}/appliance/trafficShaping/uplinkSelection
    Uplink bandwidth endpoint

    URL: /networks/{networkId}/appliance/trafficShaping/uplinkBandwidth
    Table 5. 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 6. 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 7. 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 8. 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 9. Device inventory endpoint
    Description Endpoint
    Device inventory endpoint

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

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