{"type":"api","title":"Get Organization Switch Ports Transceivers Readings History By Switch","meta":{"id":"/apps/pubhub/media/Meraki-Dashboard-API-v1-Documentation/4a73587b50c21afbda73cffb32f23c0279bf8383/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: 04 December, 2024\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.53.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":"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":"interfaces"},{"name":"internetPolicies"},{"name":"intrusion"},{"name":"inventory"},{"name":"ipv6"},{"name":"jobs"},{"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":"locationScanning"},{"name":"loginSecurity"},{"name":"logs"},{"name":"lossAndLatencyHistory"},{"name":"macTable"},{"name":"malware"},{"name":"managementInterface"},{"name":"manufacturers"},{"name":"me"},{"name":"merakiAuthUsers"},{"name":"meshStatuses"},{"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":"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":"priorities"},{"name":"privateApplicationGroups"},{"name":"privateApplications"},{"name":"privateResources"},{"name":"profiles"},{"name":"provisioning"},{"name":"publicApplications"},{"name":"qosRules"},{"name":"qualityAndRetention"},{"name":"qualityRetentionProfiles"},{"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":"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":"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 time-series digital optical monitoring (DOM) readings for ports on each DOM-enabled switch in an organization, in addition to thresholds for each relevant Small Form Factor Pluggable (SFP) module.","operationId":"getOrganizationSwitchPortsTransceiversReadingsHistoryBySwitch","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 30 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 30 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 30 days. The default is 1 day. If interval is provided, the timespan will be autocalculated.","schema":{"type":"number","format":"float","maximum":2592000}},{"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":"Networks for which information should be gathered.","schema":{"type":"array","items":{"type":"string"}}},{"name":"serials","in":"query","description":"Optional parameter to filter usage by switch.","schema":{"type":"array","items":{"type":"string"}}},{"name":"portIds","in":"query","description":"Optional parameter to filter usage by port ID.","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 switch"},"ports":{"type":"array","items":{"type":"object","properties":{"portId":{"type":"string","description":"Unique identifier for the port"},"readings":{"type":"array","items":{"type":"object","properties":{"startTs":{"type":"string","format":"date-time","description":"Timestamp for the beginning of the bandwidth usage snapshot, exclusive."},"endTs":{"type":"string","format":"date-time","description":"Timestamp for the end of the bandwidth usage snapshot, inclusive."},"sfpProductId":{"type":"string","description":"The product ID for the Small Form Factor Pluggable (SFP) currently inserted into the given port"},"thresholdSetId":{"type":"string","description":"Unique identifier used to associate readings from the Small Form Factor Pluggable (SFP) module to the appropriate set of thresholds"},"byMetric":{"type":"object","properties":{"power":{"type":"object","properties":{"transmit":{"type":"object","properties":{"minimum":{"type":"number","format":"float","description":"The minimum value for power transmitted by the port over the interval, in dBm"},"maximum":{"type":"number","format":"float","description":"The maximum value for power transmitted by the port over the interval, in dBm"},"median":{"type":"number","format":"float","description":"The median value for power transmitted by the port over the interval, in dBm"}},"description":"Information about the power transmitted by the port"},"receive":{"type":"object","properties":{"minimum":{"type":"number","format":"float","description":"The minimum value for power received by the port over the interval, in dBm"},"maximum":{"type":"number","format":"float","description":"The maximum value for power received by the port over the interval, in dBm"},"median":{"type":"number","format":"float","description":"The median value for power received by the port over the interval, in dBm"}},"description":"Information about the power received by the port"}},"description":"Information about the power transmitted and received by the port"},"temperature":{"type":"object","properties":{"fahrenheit":{"type":"object","properties":{"minimum":{"type":"number","format":"float","description":"The minimum temperature of the port over the interval, in fahrenheit"},"maximum":{"type":"number","format":"float","description":"The maximum temperature of the port over the interval, in fahrenheit"},"median":{"type":"number","format":"float","description":"The median temperature of the port over the interval, in fahrenheit"}},"description":"Information about the temperature of the port in fahrenheit"},"celsius":{"type":"object","properties":{"minimum":{"type":"number","format":"float","description":"The minimum temperature of the port over the interval, in celsius"},"maximum":{"type":"number","format":"float","description":"The maximum temperature of the port over the interval, in celsius"},"median":{"type":"number","format":"float","description":"The median temperature of the port over the interval, in celsius"}},"description":"Information about the temperature of the port in celsius"}},"description":"Information about the temperature of the port"},"supplyVoltage":{"type":"object","properties":{"level":{"type":"object","properties":{"minimum":{"type":"number","format":"float","description":"The minimum supply voltage for the port over the interval, in volts"},"maximum":{"type":"number","format":"float","description":"The maximum supply voltage for the port over the interval, in volts"},"median":{"type":"number","format":"float","description":"The median supply voltage for the port over the interval, in volts"}},"description":"Information about the supply voltage level of the port, in volts"}},"description":"Information about the supply voltage of the port"},"laserBiasCurrent":{"type":"object","properties":{"draw":{"type":"object","properties":{"minimum":{"type":"number","format":"float","description":"The minimum laser bias current for the port over the interval, in mA"},"maximum":{"type":"number","format":"float","description":"The maximum laser bias current for the port over the interval, in mA"},"median":{"type":"number","format":"float","description":"The median laser bias current for the port over the interval, in mA"}},"description":"Information about the laser bias current draw of the port, in mA"}},"description":"Information about the laser bias current of the port"}},"description":"All reading data, grouped by the reading metric"}}},"description":"The digital optical monitoring readings for the individual port, with the most recent snapshot first"}}},"description":"The ports associated with the given switch"},"network":{"type":"object","properties":{"id":{"type":"string","description":"The network ID"},"name":{"type":"string","description":"The name of the network"}},"description":"Information regarding the network the switch belongs to"}}},"description":"The top-level propery containing all digital optical monitorting 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."},"units":{"type":"object","properties":{"power":{"type":"object","properties":{"name":{"type":"string","description":"The name of the unit for transmit and receive power values"},"symbol":{"type":"string","description":"The symbol of the unit for transmit and receive power values"}},"description":"The units for the transmit and receive power values"},"supplyVoltage":{"type":"object","properties":{"name":{"type":"string","description":"The name of the unit for supply voltage values"},"symbol":{"type":"string","description":"The symbol of the unit for supply voltage values"}},"description":"The units for the supply voltage values"},"laserBiasCurrent":{"type":"object","properties":{"name":{"type":"string","description":"The name of the unit for laser bias current values"},"symbol":{"type":"string","description":"The symbol of the unit for laser bias current values"}},"description":"The units for the laser bias current values"}},"description":"Information about which units each reading is provided in"},"thresholds":{"type":"array","items":{"type":"object","properties":{"thresholdSetId":{"type":"string","description":"Unique identifier used to associate readings from the Small Form Factor Pluggable (SFP) module to the appropriate set of thresholds"},"power":{"type":"object","properties":{"transmit":{"type":"object","properties":{"error":{"type":"object","properties":{"upper":{"type":"number","format":"float","description":"The value in dBm at or above which the transmitted power is considered to be in an error state"},"lower":{"type":"number","format":"float","description":"The value in dBm at or below which the transmitted power is considered to be in an error state"}},"description":"Error thresholds for the power transmitted by the port"},"warning":{"type":"object","properties":{"upper":{"type":"number","format":"float","description":"The value in dBm at or above which the transmitted power is considered to be in a warning state"},"lower":{"type":"number","format":"float","description":"The value in dBm at or below which the transmitted power is considered to be in a warning state"}},"description":"Warning thresholds for the power transmitted by the port"}},"description":"Thresholds for the power transmitted by the port"},"receive":{"type":"object","properties":{"error":{"type":"object","properties":{"upper":{"type":"number","format":"float","description":"The value in dBm at or above which the received power is considered to be in an error state"},"lower":{"type":"number","format":"float","description":"The value in dBm at or below which the received power is considered to be in an error state"}},"description":"Error thresholds for the power received by the port"},"warning":{"type":"object","properties":{"upper":{"type":"number","format":"float","description":"The value in dBm at or above which the received power is considered to be in a warning state"},"lower":{"type":"number","format":"float","description":"The value in dBm at or below which the received power is considered to be in a warning state"}},"description":"Warning thresholds for the power received by the port"}},"description":"Thresholds for the power received by the port"}},"description":"Minimum/maximum error and warning thresholds for power readings"},"temperature":{"type":"object","properties":{"fahrenheit":{"type":"object","properties":{"error":{"type":"object","properties":{"upper":{"type":"number","format":"float","description":"The value in fahrenheit at or above which the temperature is considered to be in an error state"},"lower":{"type":"number","format":"float","description":"The value in fahrenheit at or below which the temperature is considered to be in an error state"}},"description":"Error thresholds for the temperature in fahrenheit of the port"},"warning":{"type":"object","properties":{"upper":{"type":"number","format":"float","description":"The value in fahrenheit at or above which the temperature is considered to be in a warning state"},"lower":{"type":"number","format":"float","description":"The value in fahrenheit at or below which the temperature is considered to be in a warning state"}},"description":"Warning thresholds for the temperature in fahrenheit of the port"}},"description":"Thresholds for the temperature in fahrenheit of the port"},"celsius":{"type":"object","properties":{"error":{"type":"object","properties":{"upper":{"type":"number","format":"float","description":"The value in celsius at or above which the temperature is considered to be in an error state"},"lower":{"type":"number","format":"float","description":"The value in celsius at or below which the temperature is considered to be in an error state"}},"description":"Error thresholds for the temperature in celsius of the port"},"warning":{"type":"object","properties":{"upper":{"type":"number","format":"float","description":"The value in celsius at or above which the temperature is considered to be in a warning state"},"lower":{"type":"number","format":"float","description":"The value in celsius at or below which the temperature is considered to be in a warning state"}},"description":"Warning thresholds for the temperature in celsius of the port"}},"description":"Thresholds for the temperature in celsius of the port"}},"description":"Minimum/maximum error and warning thresholds for temperature readings"},"supplyVoltage":{"type":"object","properties":{"level":{"type":"object","properties":{"error":{"type":"object","properties":{"upper":{"type":"number","format":"float","description":"The value in volts at or above which the supply voltage is considered to be in an error state"},"lower":{"type":"number","format":"float","description":"The value in volts at or below which the supply voltage is considered to be in an error state"}},"description":"Error thresholds for supply voltage level of the port"},"warning":{"type":"object","properties":{"upper":{"type":"number","format":"float","description":"The value in volts at or above which the supply voltage is considered to be in a warning state"},"lower":{"type":"number","format":"float","description":"The value in volts at or below which the supply voltage is considered to be in a warning state"}},"description":"Warning thresholds for supply voltage level of the port"}},"description":"Thresholds for supply voltage level of the port"}},"description":"Minimum/maximum error and warning thresholds for supply voltage readings"},"laserBiasCurrent":{"type":"object","properties":{"draw":{"type":"object","properties":{"error":{"type":"object","properties":{"upper":{"type":"number","format":"float","description":"The value in mA at or above which the laser bias current is considered to be in an error state"},"lower":{"type":"number","format":"float","description":"The value in mA at or below which the laser bias current is considered to be in an error state"}},"description":"Error thresholds for laser bias current draw of the port"},"warning":{"type":"object","properties":{"upper":{"type":"number","format":"float","description":"The value in mA at or above which the laser bias current is considered to be in a warning state"},"lower":{"type":"number","format":"float","description":"The value in mA at or below which the laser bias current is considered to be in a warning state"}},"description":"Warning thresholds for laser bias current draw of the port"}},"description":"Thresholds for laser bias current draw of the port"}},"description":"Minimum/maximum error and warning thresholds for laser bias current readings"}}},"description":"Thresholds to be applied to each metric in order to derive error/warning states."}},"description":"Other metadata related to this result set."}}},"example":{"items":[{"serial":"Q234-ABCD-0001","ports":[{"portId":"1","readings":[{"startTs":"2018-02-11T00:00:00.090210Z","endTs":"2018-02-11T00:00:00.090210Z","sfpProductId":"PRODUCT1","thresholdSetId":"ABC123","byMetric":{"power":{"transmit":{"minimum":4,"maximum":5,"median":4.5},"receive":{"minimum":4,"maximum":5,"median":4.5}},"temperature":{"fahrenheit":{"minimum":30,"maximum":33,"median":32},"celsius":{"minimum":-1.1,"maximum":0.6,"median":0}},"supplyVoltage":{"level":{"minimum":3,"maximum":3.33,"median":3.11}},"laserBiasCurrent":{"draw":{"minimum":5,"maximum":7,"median":5.5}}}}]}],"network":{"id":"N_12345678","name":"San Francisco Office"}}],"meta":{"counts":{"items":{"total":4,"remaining":2}},"units":{"power":{"name":"decibel milliwatts","symbol":"dBm"},"supplyVoltage":{"name":"volts","symbol":"V"},"laserBiasCurrent":{"name":"milliamps","symbol":"mA"}},"thresholds":[{"thresholdSetId":"ABC123","power":{"transmit":{"error":{"upper":1.8,"lower":0.3},"warning":{"upper":1.5,"lower":0.6}},"receive":{"error":{"upper":1.8,"lower":0.3},"warning":{"upper":1.5,"lower":0.6}}},"temperature":{"fahrenheit":{"error":{"upper":59,"lower":23},"warning":{"upper":50,"lower":14}},"celsius":{"error":{"upper":15,"lower":-5},"warning":{"upper":10,"lower":-10}}},"supplyVoltage":{"level":{"error":{"upper":7,"lower":2},"warning":{"upper":6,"lower":3}}},"laserBiasCurrent":{"draw":{"error":{"upper":6,"lower":1},"warning":{"upper":5,"lower":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 time-series digital optical monitoring (DOM) readings for ports on each DOM-enabled switch in an organization, in addition to thresholds for each relevant Small Form Factor Pluggable (SFP) module.","tags":["switch","monitor","ports","transceivers","readings","history","bySwitch"],"x-release-stage":"beta","__originalOperationId":"getOrganizationSwitchPortsTransceiversReadingsHistoryBySwitch","security":[{"meraki_api_key":[]},{"bearerAuth":[]}],"method":"get","path":"/organizations/{organizationId}/switch/ports/transceivers/readings/history/bySwitch"}}