{"type":"api","title":"Get Integration","meta":{"id":"/apps/pubhub/media/Meraki-Dashboard-API-v1-Documentation/14ef7049b5106a90d0c4b9d056dd0529931d50a2/906c5292-7ca5-3d85-bb6d-da1ee73c8be6","info":{"title":"Meraki Dashboard API","description":"A RESTful API to programmatically manage and monitor Cisco Meraki networks at scale.\n\n\u003e Date: 09 September, 2026\n\u003e\n\u003e [Recent Updates](https://meraki.io/whats-new/)\n\n---\n\n[API Documentation](https://meraki.io/api)\n\n[Community Support](https://meraki.io/community)\n\n[Meraki Homepage](https://www.meraki.com)\n","contact":{"name":"Meraki Developer Community","url":"https://meraki.io/community"},"version":"1.74.0-beta.1"},"security":[{"meraki_api_key":[]},{"bearerAuth":[]},{"oauth2":[]}],"tags":[{"name":"organizations"},{"name":"networks"},{"name":"devices"},{"name":"insight"},{"name":"wireless"},{"name":"camera"},{"name":"appliance"},{"name":"switch"},{"name":"cellularGateway"},{"name":"sm"},{"name":"sensor"},{"name":"administered"},{"name":"campusGateway"},{"name":"users"},{"name":"wirelessController"},{"name":"spaces"},{"name":"support"},{"name":"assistant"},{"name":"accelerometer"},{"name":"accessControlLists"},{"name":"accessGroups"},{"name":"accessPolicies"},{"name":"account"},{"name":"accounts"},{"name":"aclHitCount"},{"name":"acls"},{"name":"actionBatches"},{"name":"activities"},{"name":"adaptivePolicy"},{"name":"adaptivePolicyGroups"},{"name":"addressFamilies"},{"name":"addresses"},{"name":"administrators"},{"name":"admins"},{"name":"afc"},{"name":"airMarshal"},{"name":"alertTypes"},{"name":"alerts"},{"name":"allowlist"},{"name":"alternateManagementInterface"},{"name":"analytics"},{"name":"api"},{"name":"apiRequests"},{"name":"apnsCert"},{"name":"apple"},{"name":"appliances"},{"name":"application"},{"name":"applicationCategories"},{"name":"applicationUsage"},{"name":"applications"},{"name":"areas"},{"name":"arpInspection"},{"name":"arpTable"},{"name":"artifacts"},{"name":"assets"},{"name":"assignments"},{"name":"association"},{"name":"attributes"},{"name":"auth"},{"name":"authZones"},{"name":"authentication"},{"name":"authenticationToken"},{"name":"authorities"},{"name":"authorization"},{"name":"authorizations"},{"name":"autoLocate"},{"name":"autoRf"},{"name":"automate"},{"name":"automations"},{"name":"autonomousSystems"},{"name":"availabilities"},{"name":"azure"},{"name":"bands"},{"name":"bandwidthUsageHistory"},{"name":"bgp"},{"name":"bgpSessionStatus"},{"name":"billing"},{"name":"blink"},{"name":"bluetooth"},{"name":"bluetoothClients"},{"name":"bonjourForwarding"},{"name":"boots"},{"name":"boundaries"},{"name":"brandingPolicies"},{"name":"buildings"},{"name":"bulk"},{"name":"bulkAdd"},{"name":"bulkCreate"},{"name":"bulkDelete"},{"name":"bulkEdit"},{"name":"bulkEnrollment"},{"name":"bulkRemove"},{"name":"bulkUpdate"},{"name":"bulkUpload"},{"name":"byAdmin"},{"name":"byApplication"},{"name":"byAutonomousSystem"},{"name":"byBand"},{"name":"byBoundary"},{"name":"byClient"},{"name":"byClientOs"},{"name":"byClientType"},{"name":"byCluster"},{"name":"byDevice"},{"name":"byEnergyUsage"},{"name":"byFilterList"},{"name":"byGroup"},{"name":"byInterval"},{"name":"byMetric"},{"name":"byModel"},{"name":"byNetwork"},{"name":"byNewDevice"},{"name":"byOperation"},{"name":"byPeerGroup"},{"name":"byPipeline"},{"name":"byPort"},{"name":"byPrefixList"},{"name":"byProfile"},{"name":"byRouter"},{"name":"byServer"},{"name":"byServerType"},{"name":"bySite"},{"name":"bySourceIp"},{"name":"bySsid"},{"name":"byStack"},{"name":"byStatus"},{"name":"bySwitch"},{"name":"bySwitchProfile"},{"name":"byType"},{"name":"byUsage"},{"name":"byUtilization"},{"name":"byVlan"},{"name":"byVrf"},{"name":"bypassActivationLockAttempts"},{"name":"cableTest"},{"name":"callbacks"},{"name":"capabilities"},{"name":"captures"},{"name":"categories"},{"name":"cellular"},{"name":"cellularFirewallRules"},{"name":"cellularUsageHistory"},{"name":"certificateAuthority"},{"name":"certificates"},{"name":"certs"},{"name":"changeHistory"},{"name":"changelogs"},{"name":"channelAvailability"},{"name":"channelUtilization"},{"name":"channelUtilizationHistory"},{"name":"channels"},{"name":"chat"},{"name":"checkup"},{"name":"claim"},{"name":"claimKey"},{"name":"clientCountHistory"},{"name":"clientExclusion"},{"name":"clients"},{"name":"cloud"},{"name":"cloudEnrollment"},{"name":"clusters"},{"name":"commands"},{"name":"communicationPlans"},{"name":"completions"},{"name":"compliance"},{"name":"compute"},{"name":"config"},{"name":"configTemplates"},{"name":"configurationChanges"},{"name":"configurations"},{"name":"configure"},{"name":"configuredDevices"},{"name":"connectedCountHistory"},{"name":"connectionStats"},{"name":"connections"},{"name":"connectivity"},{"name":"connectivityEvents"},{"name":"connectivityMonitoringDestinations"},{"name":"connectors"},{"name":"contentFiltering"},{"name":"contents"},{"name":"controller"},{"name":"correlated"},{"name":"coterm"},{"name":"coverage"},{"name":"cpu"},{"name":"credentials"},{"name":"crls"},{"name":"current"},{"name":"customAnalytics"},{"name":"customPerformanceClasses"},{"name":"cycle"},{"name":"data"},{"name":"dataRate"},{"name":"dataRateHistory"},{"name":"defaultContent"},{"name":"delegated"},{"name":"deltas"},{"name":"deploy"},{"name":"deployable"},{"name":"deployed"},{"name":"deployments"},{"name":"descriptors"},{"name":"desktopLogs"},{"name":"details"},{"name":"detections"},{"name":"deviceCommandLogs"},{"name":"deviceProfiles"},{"name":"deviceTypeGroupPolicies"},{"name":"dhcp"},{"name":"dhcpLeases"},{"name":"dhcpServerPolicy"},{"name":"dictionaries"},{"name":"disconnect"},{"name":"discover"},{"name":"discovered"},{"name":"discovery"},{"name":"disenrollments"},{"name":"dns"},{"name":"domains"},{"name":"doorLocks"},{"name":"download"},{"name":"downloadUrl"},{"name":"dscpTaggingOptions"},{"name":"dscpToCosMappings"},{"name":"eapOverride"},{"name":"earlyAccess"},{"name":"electronicShelfLabel"},{"name":"eligible"},{"name":"enrollments"},{"name":"entitlements"},{"name":"entries"},{"name":"eox"},{"name":"errors"},{"name":"esims"},{"name":"ethernet"},{"name":"eventLogs"},{"name":"eventTypes"},{"name":"events"},{"name":"exclusions"},{"name":"experience"},{"name":"extensions"},{"name":"facets"},{"name":"failedConnections"},{"name":"failover"},{"name":"failures"},{"name":"featureTiers"},{"name":"features"},{"name":"feedback"},{"name":"fetchTableQuery"},{"name":"fields"},{"name":"filterLists"},{"name":"filters"},{"name":"firewall"},{"name":"firewalledServices"},{"name":"firmware"},{"name":"firmwareUpgrades"},{"name":"floorPlans"},{"name":"gateways"},{"name":"gcp"},{"name":"geolocations"},{"name":"global"},{"name":"group"},{"name":"groupPolicies"},{"name":"groups"},{"name":"health"},{"name":"healthByTime"},{"name":"healthScores"},{"name":"histogram"},{"name":"historical"},{"name":"history"},{"name":"hosts"},{"name":"hotspot20"},{"name":"httpServers"},{"name":"httpsi"},{"name":"hubs"},{"name":"iam"},{"name":"identities"},{"name":"identity"},{"name":"identityPsks"},{"name":"idps"},{"name":"impacted"},{"name":"impactedDevice"},{"name":"import"},{"name":"inboundCellularFirewallRules"},{"name":"inboundFirewallRules"},{"name":"insights"},{"name":"integrate"},{"name":"integration"},{"name":"integrations"},{"name":"interconnects"},{"name":"interfaces"},{"name":"internetPolicies"},{"name":"intrusion"},{"name":"inventory"},{"name":"ipAssignment"},{"name":"ipsec"},{"name":"ipv6"},{"name":"isolation"},{"name":"jobs"},{"name":"json"},{"name":"keys"},{"name":"l2"},{"name":"l3"},{"name":"l3FirewallRules"},{"name":"l7FirewallRules"},{"name":"lan"},{"name":"lanLink"},{"name":"lanStp"},{"name":"latency"},{"name":"latencyHistory"},{"name":"latencyStats"},{"name":"latest"},{"name":"leds"},{"name":"license"},{"name":"licenses"},{"name":"licensing"},{"name":"lines"},{"name":"linkAggregations"},{"name":"linkLayer"},{"name":"links"},{"name":"listenRanges"},{"name":"live"},{"name":"liveTools"},{"name":"lldpCdp"},{"name":"load"},{"name":"local"},{"name":"localOverrides"},{"name":"location"},{"name":"locationScanning"},{"name":"loginSecurity"},{"name":"logins"},{"name":"logs"},{"name":"lookups"},{"name":"lossAndLatencyHistory"},{"name":"lowPower"},{"name":"macTable"},{"name":"malware"},{"name":"managementInterface"},{"name":"manufacturers"},{"name":"masks"},{"name":"mcf"},{"name":"mdns"},{"name":"me"},{"name":"memory"},{"name":"merakiAuth"},{"name":"merakiAuthUsers"},{"name":"meshStatuses"},{"name":"messages"},{"name":"metrics"},{"name":"migrations"},{"name":"mirror"},{"name":"mirrors"},{"name":"mode"},{"name":"models"},{"name":"monitor"},{"name":"monitoredMediaServers"},{"name":"mostImpactedClientNetworks"},{"name":"mostImpactedNetworks"},{"name":"mostImpactedXMs"},{"name":"moves"},{"name":"mqtt"},{"name":"mqttBrokers"},{"name":"mtu"},{"name":"multicast"},{"name":"multicastForwarding"},{"name":"multicastRouting"},{"name":"nac"},{"name":"nat"},{"name":"neighbors"},{"name":"netflow"},{"name":"networkAdapters"},{"name":"networkHealth"},{"name":"networkServices"},{"name":"new"},{"name":"nodes"},{"name":"objectDetectionModels"},{"name":"offboard"},{"name":"onboard"},{"name":"onboarding"},{"name":"onboardingHistory"},{"name":"oneToManyNatRules"},{"name":"oneToOneNatRules"},{"name":"openRoaming"},{"name":"openapiSpec"},{"name":"opportunistic"},{"name":"opportunisticPcap"},{"name":"optIns"},{"name":"optimization"},{"name":"order"},{"name":"orders"},{"name":"ospf"},{"name":"ospfNeighbors"},{"name":"override"},{"name":"overrides"},{"name":"overview"},{"name":"overviews"},{"name":"owe"},{"name":"package"},{"name":"packetCapture"},{"name":"packetCaptures"},{"name":"packetLoss"},{"name":"packets"},{"name":"payloadTemplates"},{"name":"peers"},{"name":"performance"},{"name":"performanceHistory"},{"name":"permissions"},{"name":"pii"},{"name":"piiKeys"},{"name":"ping"},{"name":"pingDevice"},{"name":"pipelines"},{"name":"placement"},{"name":"planning"},{"name":"poe"},{"name":"policies"},{"name":"policy"},{"name":"policyObjects"},{"name":"portForwardingRules"},{"name":"portSchedules"},{"name":"ports"},{"name":"position"},{"name":"positions"},{"name":"power"},{"name":"powerLimits"},{"name":"powerModules"},{"name":"prefixLists"},{"name":"prefixes"},{"name":"priorities"},{"name":"privateApplicationGroups"},{"name":"privateApplications"},{"name":"privateResourceGroups"},{"name":"privateResources"},{"name":"productAnnouncements"},{"name":"productIntegrations"},{"name":"profiles"},{"name":"provisioning"},{"name":"publicApplications"},{"name":"push"},{"name":"qosRules"},{"name":"qualityAndRetention"},{"name":"qualityRetentionProfiles"},{"name":"queues"},{"name":"raGuardPolicy"},{"name":"radio"},{"name":"radius"},{"name":"radsec"},{"name":"ratePlans"},{"name":"rca"},{"name":"readings"},{"name":"reboot"},{"name":"receivers"},{"name":"recent"},{"name":"recommendations"},{"name":"records"},{"name":"redundancy"},{"name":"regions"},{"name":"regulatoryDomain"},{"name":"relationships"},{"name":"remoteAccess"},{"name":"remoteAccessLog"},{"name":"remoteAccessLogsExports"},{"name":"removedResources"},{"name":"rendezvousPoints"},{"name":"requests"},{"name":"requirements"},{"name":"responseCodes"},{"name":"rest"},{"name":"restrictions"},{"name":"revocationLists"},{"name":"rfHealth"},{"name":"rfProfiles"},{"name":"roaming"},{"name":"roles"},{"name":"rollbacks"},{"name":"routeTableAssociations"},{"name":"routeTables"},{"name":"routers"},{"name":"routing"},{"name":"routingTable"},{"name":"rrm"},{"name":"rssi"},{"name":"ruleGroups"},{"name":"rules"},{"name":"rulesets"},{"name":"salesRepresentatives"},{"name":"saml"},{"name":"samlRoles"},{"name":"sase"},{"name":"scanning"},{"name":"schedules"},{"name":"scores"},{"name":"sdwan"},{"name":"sdwanmanager"},{"name":"search"},{"name":"secureClient"},{"name":"secureConnect"},{"name":"security"},{"name":"securityCenters"},{"name":"seen"},{"name":"sense"},{"name":"sentry"},{"name":"serverHealth"},{"name":"servers"},{"name":"serviceProviders"},{"name":"sessions"},{"name":"settings"},{"name":"signalQuality"},{"name":"signalQualityHistory"},{"name":"sims"},{"name":"singleLan"},{"name":"siteToSite"},{"name":"siteToSiteVpn"},{"name":"sites"},{"name":"slas"},{"name":"smDevicesForKey"},{"name":"smOwnersForKey"},{"name":"snmp"},{"name":"software"},{"name":"softwares"},{"name":"spanningTree"},{"name":"speedTest"},{"name":"speedTestResults"},{"name":"splash"},{"name":"splashAuthorizationStatus"},{"name":"splashLoginAttempts"},{"name":"split"},{"name":"ssids"},{"name":"stacks"},{"name":"staged"},{"name":"stages"},{"name":"states"},{"name":"static"},{"name":"staticRoutes"},{"name":"statics"},{"name":"stats"},{"name":"status"},{"name":"statuses"},{"name":"stickyEvents"},{"name":"stormControl"},{"name":"stp"},{"name":"subnetPool"},{"name":"subnets"},{"name":"subscription"},{"name":"subscriptions"},{"name":"successfulConnections"},{"name":"successfulConnects"},{"name":"summaries"},{"name":"summary"},{"name":"summaryPanel"},{"name":"supported"},{"name":"swap"},{"name":"swaps"},{"name":"switchPortStatus"},{"name":"switches"},{"name":"sync"},{"name":"syncJobs"},{"name":"syslog"},{"name":"syslogServers"},{"name":"system"},{"name":"tags"},{"name":"targetGroups"},{"name":"targets"},{"name":"tasks"},{"name":"taxonomy"},{"name":"telemetry"},{"name":"testConnectivity"},{"name":"tests"},{"name":"themes"},{"name":"thirdPartyVPNPeers"},{"name":"thousandEyes"},{"name":"threads"},{"name":"throughputTest"},{"name":"timeToConnect"},{"name":"token"},{"name":"tokens"},{"name":"top"},{"name":"topics"},{"name":"topology"},{"name":"towers"},{"name":"traceRoute"},{"name":"traffic"},{"name":"trafficAnalysis"},{"name":"trafficHistory"},{"name":"trafficShaping"},{"name":"transceivers"},{"name":"traps"},{"name":"trustedAccessConfigs"},{"name":"trustedServers"},{"name":"tunnelCreation"},{"name":"tunnelStatus"},{"name":"tunnelable"},{"name":"tunneling"},{"name":"types"},{"name":"umbrella"},{"name":"unassigned"},{"name":"update"},{"name":"updates"},{"name":"upgrades"},{"name":"uplink"},{"name":"uplinkBandwidth"},{"name":"uplinkSelection"},{"name":"uplinks"},{"name":"uplinksLossAndLatency"},{"name":"usage"},{"name":"usageHistories"},{"name":"usageHistory"},{"name":"userAccessDevices"},{"name":"utilization"},{"name":"v4"},{"name":"values"},{"name":"versions"},{"name":"video"},{"name":"videoLink"},{"name":"videoWalls"},{"name":"vlanAssignments"},{"name":"vlanProfiles"},{"name":"vlans"},{"name":"vmx"},{"name":"vpcOnboardingBatches"},{"name":"vpcs"},{"name":"vpn"},{"name":"vpnExclusions"},{"name":"vpnFirewallRules"},{"name":"vpnPeers"},{"name":"vppAccounts"},{"name":"vrfs"},{"name":"vrrp"},{"name":"vrrpTable"},{"name":"wakeOnLan"},{"name":"warmSpare"},{"name":"warnings"},{"name":"webApps"},{"name":"webhookTests"},{"name":"webhooks"},{"name":"wired"},{"name":"wirelessControllers"},{"name":"wirelessProfiles"},{"name":"wlanLists"},{"name":"workflows"},{"name":"xdr"},{"name":"zigbee"},{"name":"zones"},{"name":"ztrIntents"}],"x-parser-conf":{"overview":{"markdownPath":"docs/overview-early-access.md"},"theme":"meraki","serverConfig":true,"httpBearer":{"bearerToken":"75dd5334bef4d2bc96f26138c163c0a3fa0b5ca6"},"labelConfig":{"endpoint":{"field":"operationId","format":"startCase"}},"groupBy":{"$remoteModule":"config/group_platform.js"},"filterBy":{"$remoteModule":"config/filter_only_beta.js"},"sortBy":{"$remoteModule":"config/sort_by.js"},"exampleAsDefault":true,"expand":0,"variables":{"organizationId":"1215707","networkId":"N_784752235069315754","serial":"QBSB-VQ3J-XZ54"}},"openapi":"3.0.1","servers":[{"url":"https://api.meraki.com/{basePath}","variables":{"basePath":{"default":"api/v1"}}}],"securitySchemes":{"meraki_api_key":{"type":"apiKey","name":"X-Cisco-Meraki-API-Key","in":"header"},"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key"},"oauth2":{"type":"oauth2","description":"This API uses OAuth 2 with the authorization code grant flow. [More info](https://developer.cisco.com/meraki/api-v1/authorization/)","flows":{"authorizationCode":{"authorizationUrl":"https://as.meraki.com/oauth/authorize","tokenUrl":"https://as.meraki.com/oauth/token","scopes":{"camera:config:read":"Cameras (MV)","camera:config:write":"Cameras (MV)","camera:telemetry:read":"Cameras (MV)","camera:telemetry:write":"Cameras (MV)","dashboard:general:config:read":"Entire dashboard, excluding identity and access management","dashboard:general:config:write":"Entire dashboard, excluding identity and access management","dashboard:general:telemetry:read":"Entire dashboard, excluding identity and access management","dashboard:general:telemetry:write":"Entire dashboard, excluding identity and access management","dashboard:iam:config:read":"Dashboard related to identity and access management, including early access features","dashboard:iam:config:write":"Dashboard related to identity and access management, including early access features","dashboard:iam:telemetry:read":"Dashboard related to identity and access management, including early access features","dashboard:iam:telemetry:write":"Dashboard related to identity and access management, including early access features","dashboard:licensing:config:read":"Licensing","dashboard:licensing:config:write":"Licensing","dashboard:licensing:telemetry:read":"Licensing","dashboard:licensing:telemetry:write":"Licensing","iot:gateway:general:config:read":"IoT Gateway Control using NIPC","iot:gateway:general:config:write":"IoT Gateway Control using NIPC","iot:gateway:general:telemetry:read":"IoT Gateway telemetry using NIPC","iot:gateway:general:telemetry:write":"IoT Gateway telemetry using NIPC","iot:gateway:onboarding:config:read":"IoT Gateway Onboarding using SCIM","iot:gateway:onboarding:config:write":"IoT Gateway Onboarding using SCIM","policy:config:read":"Provides granular authorization over all global policy resources including policy objects, adaptive policy, and Organization Group Policy","policy:config:write":"Provides granular authorization over all global policy resources including policy objects, adaptive policy, and Organization Group Policy","policy:telemetry:read":"Provides granular authorization over all global policy resources including policy objects, adaptive policy, and Organization Group Policy","policy:telemetry:write":"Provides granular authorization over all global policy resources including policy objects, adaptive policy, and Organization Group Policy","sdwan:config:read":"Secure SD-WAN (MX including MXIGZ)","sdwan:config:write":"Secure SD-WAN (MX including MXIGZ)","sdwan:telemetry:read":"Secure SD-WAN (MX including MXIGZ)","sdwan:telemetry:write":"Secure SD-WAN (MX including MXIGZ)","sensor:config:read":"Sensors (MT)","sensor:config:write":"Sensors (MT)","sensor:telemetry:read":"Sensors (MT)","sensor:telemetry:write":"Sensors (MT)","sm:config:read":"Endpoint Management (SM)","sm:config:write":"Endpoint Management (SM)","sm:telemetry:read":"Endpoint Management (SM)","sm:telemetry:write":"Endpoint Management (SM)","switch:config:read":"Switches (MS)","switch:config:write":"Switches (MS)","switch:telemetry:read":"Switches (MS)","switch:telemetry:write":"Switches (MS)","wireless:config:read":"Wireless (MR)","wireless:config:write":"Wireless (MR)","wireless:telemetry:read":"Wireless (MR)","wireless:telemetry:write":"Wireless (MR)"}}}}}},"spec":{"description":"Returns the cloud integration identified by `integrationId`, including lifecycle and discovery state, requested capability bundles, discovery-snapshot resource counts, and non-secret provider identity metadata. Credential secrets are never returned.","operationId":"getIntegration","parameters":[{"name":"organizationId","in":"path","description":"Organization ID","schema":{"type":"string"},"required":true},{"name":"integrationId","in":"path","description":"Integration ID","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"MCN-assigned UUID of this cloud integration."},"name":{"type":"string","description":"Display name recorded for the integration. It is derived from provider identity or discovery metadata and is not a credential secret."},"provider":{"type":"string","description":"Provider represented by the integration.\n\n- `aws` — Amazon Web Services integration that discovers AWS accounts and VPCs.\n- `azure` — Microsoft Azure integration that discovers subscriptions and virtual networks (VNets).\n- `gcp` — Google Cloud integration that discovers projects and VPC networks.\n- `meraki` — MCN-managed integration used to discover Meraki Sites; public integration creation does not accept this value."},"status":{"type":"string","description":"Lifecycle state of the cloud integration. This state is distinct from the manual and automatic discovery states in `statusDetails`.\n\n- `created` — The integration record was created.\n- `discovering` — Cloud-resource discovery is running.\n- `active` — The integration is active.\n- `deleting` — Integration removal is in progress.\n- `discovery_failed` — Cloud-resource discovery failed.\n- `degraded` — The integration remains present but has a degraded condition."},"statusDetails":{"type":"object","properties":{"manualDiscovery":{"type":"object","properties":{"status":{"type":"string","description":"State of this discovery workflow.\n\n- `created` — The discovery record exists but processing has not started.\n- `pending` — Discovery is queued.\n- `discovering` — Discovery is running.\n- `succeeded` — Discovery completed without recorded warnings.\n- `succeeded_with_warnings` — Discovery completed with one or more non-fatal recorded conditions.\n- `failed` — Discovery did not complete successfully."},"errors":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Category of the discovery condition.\n\n- `permission_denied` — Provider authorization does not permit a required read or action.\n- `authentication_failed` — Submitted provider credentials could not authenticate.\n- `rate_limit_exceeded` — A provider request limit was exceeded.\n- `service_unavailable` — A required provider service was unavailable.\n- `network_error` — Communication with the provider failed.\n- `resource_not_found` — A required provider resource was not found.\n- `configuration_error` — Integration or provider configuration is invalid or incomplete.\n- `internal_error` — MCN failed internally while processing discovery.\n- `unknown_error` — The condition did not map to a more specific category."},"severity":{"type":"string","enum":["error","warning"],"description":"Effect of the recorded condition on discovery.\n\n- `error` — The condition prevented or materially limited the discovery result.\n- `warning` — The non-fatal condition was retained with a completed or partial discovery result."},"summary":{"type":"string","description":"Optional concise human-readable title for the discovery condition."},"message":{"type":"string","description":"Human-readable detail describing the discovery condition that occurred."},"outcome":{"type":"string","description":"Optional explanation of the expected integration or discovery behavior if the condition remains unresolved."},"guidance":{"type":"string","description":"Optional guidance for correcting or investigating the discovery condition."},"labels":{"type":"array","items":{"type":"object"},"description":"Optional structured labels that scope the condition to a provider sub-resource, such as a specific Azure subscription."}}},"description":"Structured errors and warnings recorded for this discovery workflow. An empty array means no conditions were recorded."},"updatedAt":{"type":"string","format":"date-time","description":"Date and time when this discovery state was most recently updated, formatted according to RFC 3339."}},"description":"State of discovery started through the integration discovery operation. Omitted when no manual discovery record is available."},"autoDiscovery":{"type":"object","properties":{"status":{"type":"string","description":"State of this discovery workflow.\n\n- `created` — The discovery record exists but processing has not started.\n- `pending` — Discovery is queued.\n- `discovering` — Discovery is running.\n- `succeeded` — Discovery completed without recorded warnings.\n- `succeeded_with_warnings` — Discovery completed with one or more non-fatal recorded conditions.\n- `failed` — Discovery did not complete successfully."},"errors":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Category of the discovery condition.\n\n- `permission_denied` — Provider authorization does not permit a required read or action.\n- `authentication_failed` — Submitted provider credentials could not authenticate.\n- `rate_limit_exceeded` — A provider request limit was exceeded.\n- `service_unavailable` — A required provider service was unavailable.\n- `network_error` — Communication with the provider failed.\n- `resource_not_found` — A required provider resource was not found.\n- `configuration_error` — Integration or provider configuration is invalid or incomplete.\n- `internal_error` — MCN failed internally while processing discovery.\n- `unknown_error` — The condition did not map to a more specific category."},"severity":{"type":"string","enum":["error","warning"],"description":"Effect of the recorded condition on discovery.\n\n- `error` — The condition prevented or materially limited the discovery result.\n- `warning` — The non-fatal condition was retained with a completed or partial discovery result."},"summary":{"type":"string","description":"Optional concise human-readable title for the discovery condition."},"message":{"type":"string","description":"Human-readable detail describing the discovery condition that occurred."},"outcome":{"type":"string","description":"Optional explanation of the expected integration or discovery behavior if the condition remains unresolved."},"guidance":{"type":"string","description":"Optional guidance for correcting or investigating the discovery condition."},"labels":{"type":"array","items":{"type":"object"},"description":"Optional structured labels that scope the condition to a provider sub-resource, such as a specific Azure subscription."}}},"description":"Structured errors and warnings recorded for this discovery workflow. An empty array means no conditions were recorded."},"updatedAt":{"type":"string","format":"date-time","description":"Date and time when this discovery state was most recently updated, formatted according to RFC 3339."}},"description":"State of automatically scheduled discovery. Omitted when no automatic discovery record is available."}},"description":"Most recent manual and automatic discovery state available for this integration. Omitted when no discovery detail is available."},"accountsCount":{"type":"integer","description":"Number of provider account records in the latest MCN discovery snapshot for this integration. An account represents an AWS account, Azure subscription, Google Cloud project, or the Meraki Dashboard organization used for Site discovery."},"vpcsCount":{"type":"integer","description":"Number of virtual networks in the latest MCN discovery snapshot for an AWS, Azure, or Google Cloud integration—AWS VPCs, Azure VNets, or Google Cloud VPC networks. The value is `0` for a Meraki integration."},"sitesCount":{"type":"integer","description":"Number of Meraki Sites in the latest MCN discovery snapshot for a Meraki integration. The value is `0` for AWS, Azure, and Google Cloud integrations."},"subnetsCount":{"type":"integer","description":"Total subnet records in the latest MCN discovery snapshot across the integration's virtual networks or Meraki Sites."},"onboardedNetworksCount":{"type":"integer","description":"Deprecated: Use `onboardedVpcsCount` for AWS, Azure, or Google Cloud integrations and `onboardedSitesCount` for Meraki integrations. This value is the latest recorded count of successfully onboarded network records."},"onboardedVpcsCount":{"type":"integer","description":"Latest recorded number of successfully onboarded AWS VPCs, Azure VNets, or Google Cloud VPC networks for this integration. The value is `0` for a Meraki integration."},"onboardedSitesCount":{"type":"integer","description":"Latest recorded number of successfully onboarded Meraki Sites for this integration. The value is `0` for AWS, Azure, and Google Cloud integrations."},"credentialType":{"type":"string","enum":["access_key","iam_role"],"description":"Credential mechanism recorded for the integration.\n\n- `iam_role` — AWS integration that assumes the IAM role identified by `aws.roleArn` using the MCN organization UUID as the external ID.\n- `access_key` — Legacy generic label used for Microsoft Azure service-principal credentials, Google Cloud service-account key JSON, and MCN-managed Meraki integrations. It does not represent a literal AWS access-key pair for those providers."},"accessRights":{"type":"array","items":{"type":"string"},"description":"Provider capability bundles requested when this integration was created. MCN validates these values at creation, but they are not operation-time authorization switches.\n\n- `discover` — Requests permissions used to inventory accounts or projects, networks, subnets, routing, and related metadata.\n- `create_onboarding_resources` — Requests permissions used to create supported provider-side gateway and VPN resources during onboarding.\n- `update_vpc` — Requests permissions associated with modifying supported cloud-network resources."},"refreshedAt":{"type":"string","format":"date-time","description":"Date and time recorded for the integration's most recent discovery refresh, formatted according to RFC 3339. Omitted when no refresh time has been recorded."},"aws":{"type":"object","properties":{"accountId":{"type":"string","description":"AWS account ID parsed from the configured IAM role ARN."},"roleArn":{"type":"string","description":"Amazon Resource Name (ARN) of the AWS IAM role that MCN assumes for this integration."}},"description":"Non-secret AWS account and assumed-role metadata. Present in a detail response for an AWS integration and omitted from list responses and other providers."},"gcp":{"type":"object","properties":{"serviceAccountClientId":{"type":"string","description":"Google-assigned numeric client ID of the service account used by this integration."},"serviceAccountClientEmail":{"type":"string","description":"Email address of the Google Cloud service account used by this integration."},"privateKeyId":{"type":"string","description":"Identifier of the service-account private key associated with this integration. The private key itself is not returned."},"parentType":{"type":"string","enum":["folder","organization"],"description":"Optional Google Cloud resource type beneath which projects are discovered.\n\n- `organization` — Discover projects beneath the Google Cloud organization identified by `parentId`.\n- `folder` — Discover projects beneath the Google Cloud folder identified by `parentId`.\n\nOmitted together with `parentId` when discovery is limited to the project identified by the service-account key."},"parentId":{"type":"string","description":"Numeric Google Cloud organization or folder resource ID selected by `parentType`. Omitted together with `parentType` when discovery is limited to the service account's project."}},"description":"Non-secret Google Cloud service-account and optional parent-scope metadata. Present in a detail response for a GCP integration and omitted from list responses and other providers."},"azure":{"type":"object","properties":{"tenantId":{"type":"string","description":"Microsoft Entra tenant (directory) ID that contains the integration's service principal."},"clientId":{"type":"string","description":"Microsoft Entra application (client) ID of the service principal used by this integration."}},"description":"Non-secret Microsoft Azure tenant and service-principal metadata. Present in a detail response for an Azure integration and omitted from list responses and other providers."},"createdAt":{"type":"string","format":"date-time","description":"Date and time when the cloud integration was created, formatted according to RFC 3339."},"updatedAt":{"type":"string","format":"date-time","description":"Date and time when the cloud integration record was most recently updated, formatted according to RFC 3339."}}},"example":{"id":"7ef094da-5ece-4d48-9ec9-8cd86c8458c0","name":"My Integration","provider":"aws","status":"active","statusDetails":{"manualDiscovery":{"status":"succeeded","errors":[{"type":"permission_denied","severity":"error","summary":"Failed to discover account name","message":"The integration is not authorized to perform the DescribeVpcs operation on ec2:vpc resources.","outcome":"The integration will display the AWS account ID instead of a friendly account name.","guidance":"Ensure the IAM role used by this integration has the following permissions: ec2:DescribeVpcs."}],"updatedAt":"2021-07-01T00:00:00Z"},"autoDiscovery":{"status":"succeeded","errors":[{"type":"permission_denied","severity":"error","summary":"Failed to discover account name","message":"The integration is not authorized to perform the DescribeVpcs operation on ec2:vpc resources.","outcome":"The integration will display the AWS account ID instead of a friendly account name.","guidance":"Ensure the IAM role used by this integration has the following permissions: ec2:DescribeVpcs."}],"updatedAt":"2021-07-01T00:00:00Z"}},"accountsCount":3,"vpcsCount":112,"sitesCount":0,"subnetsCount":212,"onboardedNetworksCount":125,"onboardedVpcsCount":125,"onboardedSitesCount":0,"credentialType":"iam_role","accessRights":["discover","create_onboarding_resources"],"refreshedAt":"2021-07-01T00:00:00Z","aws":{"accountId":"123456789012","roleArn":"arn:aws:iam::123456789012:role/Role"},"gcp":{"serviceAccountClientId":"123456789012345678901","serviceAccountClientEmail":"test@test.iam.gserviceaccount.com","privateKeyId":"e319f7d19bd24f3fe519fb0a7a87bc5d8749b3fc","parentType":"organization","parentId":"123456789"},"azure":{"tenantId":"12345678-1234-1234-1234-123456789012","clientId":"12345678-1234-1234-1234-123456789012"},"createdAt":"2021-01-01T00:00:00Z","updatedAt":"2021-01-01T00:00:00Z"}}}}},"summary":"Returns the cloud integration identified by `integrationId`, including lifecycle and discovery state, requested capability bundles, discovery-snapshot resource counts, and non-secret provider identity metadata","tags":["organizations","configure","mcf","integrations"],"x-release-stage":"beta","__originalOperationId":"getIntegration","security":[{"meraki_api_key":[]},{"bearerAuth":[]},{"oauth2":[]}],"method":"get","path":"/organizations/{organizationId}/mcf/integrations/{integrationId}"}}