Cisco Meraki Service Graph Connector API Endpoints

  • Versão de lançamento: Australia
  • Atualizado 13 de mar. de 2026
  • 2 min. de leitura

    • 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.

    Tabela 1. Organizations endpoint
    Description Endpoint
    Organizations API response

    URL:/organizations

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

    URL:/organizations/{orgId}/networks

    		 
    {                                                                    │
│    "id": "N_123456",                                                  │
│    "organizationId": "123456",                                        │
│    "name": "My Network",                                              │
│    "notes": "Network description"                                     │
│  }
    Tabela 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"                                      │
│  }
    Tabela 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"                                      │
│  }
    Tabela 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": "..."                                                │
│      }                                                                │
│    ]                                                                  │
│  }
    Tabela 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"                                   │
│          }                                                            │
│        ]                                                              │
│      }                                                                │
│    ]                                                                  │
│  }
    Tabela 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"                              │
│  }