--- sourceDocument: Australia Telecom Service Operations Management sourceDocumentLink: https://www.servicenow.com/docs/r/australia/telecom-service-ops Release : - australia ft:locale : - en-US ft:publication_title : - Australia Telecom Service Operations Management ft:clusterId : - tsom bundleId : - tsom workflow : - Customer and Industry --- # Cisco Meraki Service Graph Connector API Endpoints # Cisco Meraki Service Graph Connector API Endpoints {#ariaid-title1} Release version: Australia Updated November 5, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) 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 allows ServiceNow customers to access detailed organizational, network, device, and status information from Meraki directly within their CMDB, enabling enhanced visibility and management of network infrastructure. Show full answer Show less ## API Endpoints and Their Use * **Organizations Endpoint:** Retrieves organization details including ID, name, and management information such as MSP ID, customer number, and API IP restriction mode. * **Networks Endpoint:** Provides information about networks within an organization, including network ID, organization ID, name, and description. * **Devices Endpoint:** Returns device-specific data such as serial number, device name, network association, model, MAC address, product type, firmware version, geographic location, address, and notes. * **Device Statuses Endpoint:** Delivers current device statuses including online status, public IP, WAN IPs, gateway addresses, IP assignment types, and DNS information. * **Uplink Statuses Endpoint:** Offers detailed uplink information per device, including interface status, IP addresses, gateway, public IP, DNS servers, IP assignment method, and high availability setup. * **Switch Ports Endpoint:** Reports the status of switch ports on devices, indicating which ports are connected or disconnected and their network associations. * **Device Inventory Endpoint:** Supplies inventory details for devices including serial number, order number, and license expiration date. ## Key Benefits for ServiceNow Customers * **Comprehensive Network Visibility:** Access detailed, real-time data about organizations, networks, devices, and their statuses within the ServiceNow CMDB. * **Improved Asset and Configuration Management:** Correlate Meraki device inventory and status data to maintain accurate configuration and asset records. * **Enhanced Troubleshooting and Monitoring:** Utilize device and uplink statuses to quickly identify connectivity issues, device health, and network performance. * **Streamlined Integration:** The API endpoints provide structured, consistent data flows that enable seamless integration and automation within the ServiceNow platform. 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. {#cisco-meraki-service-graph-connector-api-endpoints__entry__2} | 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 1. Organizations endpoint] {#cisco-meraki-service-graph-connector-api-endpoints__entry__6} | Description | Endpoint | |-|-| | Networks API response `URL:/organizations/{orgId}/networks` | { │ │ "id": "N_123456", │ │ "organizationId": "123456", │ │ "name": "My Network", │ │ "notes": "Network description" │ │ } | [Table 2. Networks Endpoint] {#cisco-meraki-service-graph-connector-api-endpoints__entry__10} | 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 3. Devices Endpoint] {#cisco-meraki-service-graph-connector-api-endpoints__entry__14} | 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 4. Device statuses endpoint] {#cisco-meraki-service-graph-connector-api-endpoints__entry__18} | 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 5. Uplink statuses endpoint] {#cisco-meraki-service-graph-connector-api-endpoints__entry__22} | 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 6. Switch ports endpoint] {#cisco-meraki-service-graph-connector-api-endpoints__table_lg2_svs_5hc__entry__2} | Description | Endpoint | |-|-| | Device inventory endpoint `URL: /organizations/{orgId}/inventory/devices` | { │ │ "serial": "Q2XX-XXXX-XXXX", │ │ "orderNumber": "ORD-12345", │ │ "licenseExpirationDate": "2025-12-31" │ │ } | [Table 7. Device inventory endpoint] {#cisco-meraki-service-graph-connector-api-endpoints__table_lg2_svs_5hc}