{"type":"api","title":"Get Organization Switch Devices System Queues History By Switch By Interval","meta":{"id":"/apps/pubhub/media/Meraki-Dashboard-API-v1-Documentation/54c563b251141705e33f8803c75f598ace516aa2/401c6d5b-0873-3519-be2b-c203501ad95c","info":{"title":"Meraki Dashboard API","description":"A RESTful API to programmatically manage and monitor Cisco Meraki networks at scale.\n\n\u003e Date: 01 January, 2025\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.54.0-beta.0"},"security":[{"meraki_api_key":[]},{"bearerAuth":[]}],"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":"wirelessController"},{"name":"accessControlLists"},{"name":"accessPolicies"},{"name":"accounts"},{"name":"aclHitCount"},{"name":"acls"},{"name":"actionBatches"},{"name":"activities"},{"name":"adaptivePolicy"},{"name":"addresses"},{"name":"admins"},{"name":"afc"},{"name":"aiRrm"},{"name":"airMarshal"},{"name":"alertTypes"},{"name":"alerts"},{"name":"alternateManagementInterface"},{"name":"analytics"},{"name":"api"},{"name":"apiRequests"},{"name":"apnsCert"},{"name":"apple"},{"name":"appliances"},{"name":"applicationCategories"},{"name":"applicationUsage"},{"name":"applications"},{"name":"areas"},{"name":"arpInspection"},{"name":"arpTable"},{"name":"artifacts"},{"name":"assets"},{"name":"assignments"},{"name":"auth"},{"name":"authenticationToken"},{"name":"autoLocate"},{"name":"autoRf"},{"name":"automations"},{"name":"availabilities"},{"name":"bandwidthUsageHistory"},{"name":"bgp"},{"name":"billing"},{"name":"blink"},{"name":"bluetooth"},{"name":"bluetoothClients"},{"name":"bonjourForwarding"},{"name":"boots"},{"name":"boundaries"},{"name":"brandingPolicies"},{"name":"bulk"},{"name":"bulkCreate"},{"name":"bulkDelete"},{"name":"bulkEnrollment"},{"name":"bulkUpdate"},{"name":"byBoundary"},{"name":"byClient"},{"name":"byDevice"},{"name":"byEnergyUsage"},{"name":"byInterval"},{"name":"byMetric"},{"name":"byModel"},{"name":"byNetwork"},{"name":"byStack"},{"name":"byStatus"},{"name":"bySwitch"},{"name":"bySwitchProfile"},{"name":"byType"},{"name":"byUsage"},{"name":"byUtilization"},{"name":"bypassActivationLockAttempts"},{"name":"cableTest"},{"name":"callbacks"},{"name":"captures"},{"name":"categories"},{"name":"cellular"},{"name":"cellularFirewallRules"},{"name":"cellularUsageHistory"},{"name":"certificates"},{"name":"certs"},{"name":"changeHistory"},{"name":"channelUtilization"},{"name":"channelUtilizationHistory"},{"name":"channels"},{"name":"claim"},{"name":"claimKey"},{"name":"clientCountHistory"},{"name":"clients"},{"name":"cloud"},{"name":"cloudEnrollment"},{"name":"cloudMonitoring"},{"name":"commands"},{"name":"communicationPlans"},{"name":"compliance"},{"name":"configTemplates"},{"name":"configurationChanges"},{"name":"configure"},{"name":"configuredDevices"},{"name":"connectionStats"},{"name":"connections"},{"name":"connectivity"},{"name":"connectivityEvents"},{"name":"connectivityMonitoringDestinations"},{"name":"contentFiltering"},{"name":"contents"},{"name":"controller"},{"name":"coterm"},{"name":"current"},{"name":"customAnalytics"},{"name":"customPerformanceClasses"},{"name":"cyclePort"},{"name":"dataRateHistory"},{"name":"delegated"},{"name":"deltas"},{"name":"desktopLogs"},{"name":"details"},{"name":"detections"},{"name":"deviceCertificateAuthorities"},{"name":"deviceCommandLogs"},{"name":"deviceProfiles"},{"name":"deviceTypeGroupPolicies"},{"name":"dhcp"},{"name":"dhcpServerPolicy"},{"name":"discovery"},{"name":"disenrollments"},{"name":"dns"},{"name":"doorLocks"},{"name":"download"},{"name":"dscpTaggingOptions"},{"name":"dscpToCosMappings"},{"name":"eapOverride"},{"name":"earlyAccess"},{"name":"electronicShelfLabel"},{"name":"enrollments"},{"name":"entitlements"},{"name":"esims"},{"name":"ethernet"},{"name":"eventTypes"},{"name":"events"},{"name":"exportEvents"},{"name":"extensions"},{"name":"failedConnections"},{"name":"failover"},{"name":"features"},{"name":"fields"},{"name":"firewall"},{"name":"firewalledServices"},{"name":"firmware"},{"name":"firmwareUpgrades"},{"name":"floorPlans"},{"name":"groupPolicies"},{"name":"groups"},{"name":"health"},{"name":"healthByTime"},{"name":"healthScores"},{"name":"historical"},{"name":"history"},{"name":"hotspot20"},{"name":"httpServers"},{"name":"identities"},{"name":"identityPsks"},{"name":"idps"},{"name":"import"},{"name":"imports"},{"name":"inboundCellularFirewallRules"},{"name":"inboundFirewallRules"},{"name":"integration"},{"name":"interconnects"},{"name":"interfaces"},{"name":"internetPolicies"},{"name":"intrusion"},{"name":"inventory"},{"name":"ipv6"},{"name":"jobs"},{"name":"jupiter"},{"name":"keys"},{"name":"l2"},{"name":"l3"},{"name":"l3FirewallRules"},{"name":"l7FirewallRules"},{"name":"lan"},{"name":"latencyHistory"},{"name":"latencyStats"},{"name":"latest"},{"name":"leds"},{"name":"license"},{"name":"licenses"},{"name":"licensing"},{"name":"lines"},{"name":"linkAggregations"},{"name":"linkLayer"},{"name":"live"},{"name":"liveTools"},{"name":"lldpCdp"},{"name":"local"},{"name":"location"},{"name":"locationScanning"},{"name":"loginSecurity"},{"name":"logs"},{"name":"lossAndLatencyHistory"},{"name":"macTable"},{"name":"malware"},{"name":"managementInterface"},{"name":"manufacturers"},{"name":"me"},{"name":"memory"},{"name":"merakiAuthUsers"},{"name":"meshStatuses"},{"name":"migrations"},{"name":"mirror"},{"name":"mirrors"},{"name":"models"},{"name":"monitor"},{"name":"monitoredMediaServers"},{"name":"mqttBrokers"},{"name":"mtu"},{"name":"multicast"},{"name":"multicastForwarding"},{"name":"netflow"},{"name":"networkAdapters"},{"name":"networkHealth"},{"name":"objectDetectionModels"},{"name":"onboarding"},{"name":"onboardingHistory"},{"name":"oneToManyNatRules"},{"name":"oneToOneNatRules"},{"name":"openapiSpec"},{"name":"opportunisticPcap"},{"name":"optIns"},{"name":"order"},{"name":"orders"},{"name":"ospf"},{"name":"overview"},{"name":"packetCapture"},{"name":"packetLoss"},{"name":"packets"},{"name":"payloadTemplates"},{"name":"performance"},{"name":"performanceHistory"},{"name":"permissions"},{"name":"pii"},{"name":"piiKeys"},{"name":"ping"},{"name":"pingDevice"},{"name":"planning"},{"name":"policies"},{"name":"policy"},{"name":"policyObjects"},{"name":"portForwardingRules"},{"name":"portSchedules"},{"name":"ports"},{"name":"position"},{"name":"power"},{"name":"powerLimits"},{"name":"powerModules"},{"name":"prefixes"},{"name":"prepare"},{"name":"preview"},{"name":"priorities"},{"name":"privateApplicationGroups"},{"name":"privateApplications"},{"name":"privateResourceGroups"},{"name":"privateResources"},{"name":"profiles"},{"name":"provisioning"},{"name":"publicApplications"},{"name":"qosRules"},{"name":"qualityAndRetention"},{"name":"qualityRetentionProfiles"},{"name":"queues"},{"name":"radSec"},{"name":"radio"},{"name":"radius"},{"name":"ratePlans"},{"name":"readings"},{"name":"recent"},{"name":"records"},{"name":"redundancy"},{"name":"regions"},{"name":"relationships"},{"name":"remoteAccessLog"},{"name":"remoteAccessLogsExports"},{"name":"remove"},{"name":"rendezvousPoints"},{"name":"requests"},{"name":"requirements"},{"name":"responseCodes"},{"name":"restrictions"},{"name":"revocationList"},{"name":"rfProfiles"},{"name":"roles"},{"name":"rollbacks"},{"name":"routing"},{"name":"routingTable"},{"name":"rules"},{"name":"salesRepresentatives"},{"name":"saml"},{"name":"samlRoles"},{"name":"scanning"},{"name":"schedules"},{"name":"sdwan"},{"name":"search"},{"name":"secureConnect"},{"name":"security"},{"name":"securityCenters"},{"name":"seen"},{"name":"sense"},{"name":"sentry"},{"name":"servers"},{"name":"serviceProviders"},{"name":"settings"},{"name":"signalQualityHistory"},{"name":"sims"},{"name":"singleLan"},{"name":"siteToSiteVpn"},{"name":"sites"},{"name":"smDevicesForKey"},{"name":"smOwnersForKey"},{"name":"snmp"},{"name":"softwares"},{"name":"spaces"},{"name":"speedTest"},{"name":"speedTestResults"},{"name":"splash"},{"name":"splashAuthorizationStatus"},{"name":"splashLoginAttempts"},{"name":"split"},{"name":"ssids"},{"name":"stacks"},{"name":"staged"},{"name":"stages"},{"name":"staticRoutes"},{"name":"statics"},{"name":"stats"},{"name":"status"},{"name":"statuses"},{"name":"stormControl"},{"name":"stp"},{"name":"subnetPool"},{"name":"subnets"},{"name":"subscription"},{"name":"subscriptions"},{"name":"summary"},{"name":"support"},{"name":"supported"},{"name":"swap"},{"name":"swaps"},{"name":"switches"},{"name":"syncJobs"},{"name":"syslogServers"},{"name":"system"},{"name":"targetGroups"},{"name":"tests"},{"name":"themes"},{"name":"thirdPartyVPNPeers"},{"name":"thousandEyes"},{"name":"throughputTest"},{"name":"token"},{"name":"tokens"},{"name":"top"},{"name":"topology"},{"name":"traceRoute"},{"name":"traffic"},{"name":"trafficAnalysis"},{"name":"trafficHistory"},{"name":"trafficShaping"},{"name":"transceivers"},{"name":"traps"},{"name":"trustedAccessConfigs"},{"name":"trustedServers"},{"name":"unassigned"},{"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":"video"},{"name":"videoLink"},{"name":"vlanAssignments"},{"name":"vlanProfiles"},{"name":"vlans"},{"name":"vmx"},{"name":"vpn"},{"name":"vpnExclusions"},{"name":"vpnFirewallRules"},{"name":"vppAccounts"},{"name":"wakeOnLan"},{"name":"warmSpare"},{"name":"warnings"},{"name":"webApps"},{"name":"webhookTests"},{"name":"webhooks"},{"name":"wirelessControllers"},{"name":"wirelessProfiles"},{"name":"wlanLists"},{"name":"xdr"},{"name":"zigbee"},{"name":"zones"}],"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"}}},"spec":{"description":"Return a historical record of packet transmission and loss, broken down by protocol, for insight into switch device health.","operationId":"getOrganizationSwitchDevicesSystemQueuesHistoryBySwitchByInterval","parameters":[{"name":"organizationId","in":"path","description":"Organization ID","schema":{"type":"string"},"required":true},{"name":"perPage","in":"query","description":"The number of entries per page returned. Acceptable range is 3 - 100. Default is 50.","schema":{"type":"integer"}},{"name":"startingAfter","in":"query","description":"A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.","schema":{"type":"string"}},{"name":"endingBefore","in":"query","description":"A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.","schema":{"type":"string"}},{"name":"t0","in":"query","description":"The beginning of the timespan for the data. The maximum lookback period is 31 days from today.","schema":{"type":"string"}},{"name":"t1","in":"query","description":"The end of the timespan for the data. t1 can be a maximum of 31 days after t0.","schema":{"type":"string"}},{"name":"timespan","in":"query","description":"The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 31 days. The default is 1 day. If interval is provided, the timespan will be autocalculated.","schema":{"type":"number","format":"float","maximum":2678400}},{"name":"interval","in":"query","description":"The time interval in seconds for returned data. The valid intervals are: 300, 1200, 14400, 86400. The default is 1200. Interval is calculated if time params are provided.","schema":{"type":"integer"}},{"name":"networkIds","in":"query","description":"Optional parameter to filter connectivity history by network ID. This filter uses multiple exact matches.","schema":{"type":"array","items":{"type":"string"}}},{"name":"serials","in":"query","description":"Optional parameter to filter connectivity history by switch.","schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"serial":{"type":"string","description":"Unique serial number for the switch"},"model":{"type":"string","description":"Model of the switch"},"name":{"type":"string","description":"Name of the switch"},"mac":{"type":"string","description":"MAC address of the switch"},"tags":{"type":"array","items":{"type":"string"},"description":"List of custom tags for the switch"},"network":{"type":"object","properties":{"id":{"type":"string","description":"The network ID"},"name":{"type":"string","description":"The name of the network"},"tags":{"type":"array","items":{"type":"string"},"description":"List of custom tags for the network"}},"description":"Information regarding the network the switch belongs to"},"history":{"type":"array","items":{"type":"object","properties":{"startTs":{"type":"string","format":"date-time","description":"Timestamp for the beginning of the switch system historical snapshot, exclusive."},"endTs":{"type":"string","format":"date-time","description":"Timestamp for the end of the switch system historical snapshot, inclusive."},"counts":{"type":"object","properties":{"processed":{"type":"object","properties":{"total":{"type":"integer","description":"The total number of packets processed by the CPU during the snapshot"},"byProtocol":{"type":"object","properties":{"stp":{"type":"integer","description":"Number of Spanning Tree Protocol (STP) packets processed during the snapshot"},"ospf":{"type":"integer","description":"Number of Open Shortest Path First (OSFP) packets processed during the snapshot"},"lacp":{"type":"integer","description":"Number of Link Aggregation Control Protocol (LACP) packets processed during the snapshot"},"arp":{"type":"integer","description":"Number of Address Resolution Protocol (ARP) packets processed during the snapshot"},"management":{"type":"integer","description":"Number of Internet Protocol (IPv4 and IPv6) packets processed during the snapshot"}},"description":"Information for processed packet counts, broken down by protocol"}},"description":"Number of packets processed by the switch system"},"dropped":{"type":"object","properties":{"total":{"type":"integer","description":"The total number of packets dropped by the CPU during the snapshot"},"byProtocol":{"type":"object","properties":{"stp":{"type":"integer","description":"Number of Spanning Tree Protocol (STP) packets dropped during the snapshot"},"ospf":{"type":"integer","description":"Number of Open Shortest Path First (OSFP) packets dropped during the snapshot"},"lacp":{"type":"integer","description":"Number of Link Aggregation Control Protocol (LACP) packets dropped during the snapshot"},"arp":{"type":"integer","description":"Number of Address Resolution Protocol (ARP) packets dropped during the snapshot"},"management":{"type":"integer","description":"Number of Internet Protocol (IPv4 and IPv6) packets dropped during the snapshot"}},"description":"Number of dropped packets, broken down by protocol"}},"description":"Number of packets dropped by the switch system"}},"description":"Information, over the given interval, for the number of packets processed and dropped within the entire switch system. For standalone switches, this is the switch. For stacked switches, this is the entire stack."}}},"description":"The history of switch system data, with the most recent snapshot first"},"stack":{"type":"object","properties":{"id":{"type":"string","description":"ID of the switch stack"},"name":{"type":"string","description":"Name of the switch stack"},"members":{"type":"array","items":{"type":"object","properties":{"serial":{"type":"string","description":"Unique serial number for the member device"},"model":{"type":"string","description":"Model of the member device"},"name":{"type":"string","description":"Name of the member device"},"mac":{"type":"string","description":"MAC address of the member device"},"tags":{"type":"array","items":{"type":"string"},"description":"List of custom tags for the member device"},"history":{"type":"array","items":{"type":"object","properties":{"startTs":{"type":"string","format":"date-time","description":"Timestamp for the beginning of the historical snapshot, exclusive."},"endTs":{"type":"string","format":"date-time","description":"Timestamp for the end of the historical snapshot, inclusive."},"counts":{"type":"object","properties":{"processed":{"type":"object","properties":{"total":{"type":"integer","description":"The total number of packets processed by the CPU during the snapshot"},"byProtocol":{"type":"object","properties":{"arp":{"type":"integer","description":"Number of Address Resolution Protocol (ARP) packets processed, during the snapshot"},"management":{"type":"integer","description":"Number of Internet Protocol (IPv4 and IPv6) packets processed, during the snapshot"}},"description":"Information for processed packet counts, broken down by protocol"}},"description":"Number of packets processed by the switch system"},"dropped":{"type":"object","properties":{"total":{"type":"integer","description":"The total number of packets dropped by the CPU during the snapshot"},"byProtocol":{"type":"object","properties":{"arp":{"type":"integer","description":"Number of Address Resolution Protocol (ARP) packets dropped, during the snapshot"},"management":{"type":"integer","description":"Number of Internet Protocol (IPv4 and IPv6) packets dropped, during the snapshot"}},"description":"Number of dropped packets, broken down by protocol"}},"description":"Number of packets dropped by the switch system"}},"description":"Information, over the given interval, for the number of packets processed and dropped by the device's data plane"}}},"description":"Information, over the given interval, for the number of packets processed and dropped by the device's data plane"}}},"description":"Information about the member devices in the switch stack"}},"description":"Information about the stack for which the switch is the active node"}}},"description":"The top-level property containing all connectivity data."},"meta":{"type":"object","properties":{"counts":{"type":"object","properties":{"items":{"type":"object","properties":{"total":{"type":"integer","description":"The total number of serials."},"remaining":{"type":"integer","description":"The number of serials remaining based on current pagination location within the dataset."}},"description":"The count metadata."}},"description":"Count metadata related to this result set."}},"description":"Other metadata related to this result set."}}},"example":{"items":[{"serial":"Q234-ABCD-0001","model":"MS","name":"My switch","mac":"00:11:22:33:44:55","tags":["tag1","tag2"],"network":{"id":"N_24329156","name":"Main Office","tags":["tag1","tag2"]},"history":[{"startTs":"2018-02-11T00:00:00.090210Z","endTs":"2018-02-11T00:00:00.090210Z","counts":{"processed":{"total":9,"byProtocol":{"stp":1,"ospf":1,"lacp":1,"arp":1,"management":5}},"dropped":{"total":3,"byProtocol":{"stp":0,"ospf":1,"lacp":0,"arp":2,"management":0}}}}],"stack":{"id":"Stack ID","name":"Stack name","members":[{"serial":"Q234-ABCD-0001","model":"MS","name":"My switch","mac":"00:11:22:33:44:55","tags":["tag1","tag2"],"history":[{"startTs":"2018-02-11T00:00:00.090210Z","endTs":"2018-02-11T00:00:00.090210Z","counts":{"processed":{"total":8,"byProtocol":{"arp":2,"management":6}},"dropped":{"total":3,"byProtocol":{"arp":1,"management":2}}}}]}]}}],"meta":{"counts":{"items":{"total":4,"remaining":2}}}}}},"headers":{"Link":{"schema":{"type":"string"},"description":"A comma-separated list of first, last, prev, and next relative links used for subsequent paginated requests."}}}},"summary":"Return a historical record of packet transmission and loss, broken down by protocol, for insight into switch device health.","tags":["switch","monitor","devices","system","queues","history","bySwitch","byInterval"],"x-release-stage":"beta","__originalOperationId":"getOrganizationSwitchDevicesSystemQueuesHistoryBySwitchByInterval","security":[{"meraki_api_key":[]},{"bearerAuth":[]}],"method":"get","path":"/organizations/{organizationId}/switch/devices/system/queues/history/bySwitch/byInterval"}}