{"type":"api","title":"Get Organization Sensor Alerts","meta":{"id":"/apps/pubhub/media/Meraki-Dashboard-API-v1-Documentation/e92a64d0814b40091de22f4a93378df69809b95e/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: 20 November, 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.52.0-beta.2"},"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":"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":"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 a list of sensor alert events","operationId":"getOrganizationSensorAlerts","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 10.","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 365 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 365 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 365 days. The default is 365 days.","schema":{"type":"number","format":"float","maximum":31536000}},{"name":"sensorSerial","in":"query","description":"Filters alerts to those triggered by this sensor.","schema":{"type":"string"}},{"name":"networkIds","in":"query","required":true,"description":"Filters alerts by network. For now, this must be a single network ID.","schema":{"type":"array","items":{"type":"string"}}},{"name":"triggerMetric","in":"query","description":"Filters alerts to those triggered by this metric.","schema":{"type":"string","enum":["apparentPower","co2","current","door","frequency","humidity","indoorAirQuality","noise","pm25","powerFactor","realPower","temperature","tvoc","upstreamPower","voltage","water"]}}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"startTs":{"type":"string","format":"date-time","description":"The start time of the alert"},"sensor":{"type":"object","properties":{"name":{"type":"string","description":"Name of the sensor."},"serial":{"type":"string","description":"Serial number of the sensor."},"model":{"type":"string","description":"Model of the sensor."},"url":{"type":"string","description":"URL to the sensor."}},"required":["name","serial","model","url"],"description":"The sensor that triggered the alert"},"trigger":{"type":"object","properties":{"ts":{"type":"string","description":"Time at which the reading occurred, in ISO8601 format."},"metric":{"type":"string","enum":["apparentPower","co2","current","door","frequency","humidity","indoorAirQuality","noise","pm25","powerFactor","realPower","temperature","tvoc","upstreamPower","voltage","water"],"description":"Type of sensor reading."},"apparentPower":{"type":"object","properties":{"draw":{"type":"number","format":"float","description":"Apparent power reading in volt-amperes."}},"description":"Reading for the 'apparentPower' metric. This will only be present if the 'metric' property equals 'apparentPower'."},"co2":{"type":"object","properties":{"concentration":{"type":"integer","description":"CO2 reading in parts per million."}},"description":"Reading for the 'co2' metric. This will only be present if the 'metric' property equals 'co2'."},"current":{"type":"object","properties":{"draw":{"type":"number","format":"float","description":"Electrical current reading in amperes."}},"description":"Reading for the 'current' metric. This will only be present if the 'metric' property equals 'current'."},"door":{"type":"object","properties":{"open":{"type":"boolean","description":"True if the door is open."}},"description":"Reading for the 'door' metric. This will only be present if the 'metric' property equals 'door'."},"frequency":{"type":"object","properties":{"level":{"type":"number","format":"float","description":"Electrical current frequency reading in hertz."}},"description":"Reading for the 'frequency' metric. This will only be present if the 'metric' property equals 'frequency'."},"humidity":{"type":"object","properties":{"relativePercentage":{"type":"integer","description":"Humidity reading in %RH."}},"description":"Reading for the 'humidity' metric. This will only be present if the 'metric' property equals 'humidity'."},"indoorAirQuality":{"type":"object","properties":{"score":{"type":"integer","description":"Indoor air quality score between 0 and 100."}},"description":"Reading for the 'indoorAirQuality' metric. This will only be present if the 'metric' property equals 'indoorAirQuality'."},"noise":{"type":"object","properties":{"ambient":{"type":"object","properties":{"level":{"type":"integer","description":"Ambient noise reading in adjusted decibels."}},"description":"Ambient noise reading."}},"description":"Reading for the 'noise' metric. This will only be present if the 'metric' property equals 'noise'."},"pm25":{"type":"object","properties":{"concentration":{"type":"integer","description":"PM2.5 reading in micrograms per cubic meter."}},"description":"Reading for the 'pm25' metric. This will only be present if the 'metric' property equals 'pm25'."},"powerFactor":{"type":"object","properties":{"percentage":{"type":"integer","description":"Power factor reading as a percentage."}},"description":"Reading for the 'powerFactor' metric. This will only be present if the 'metric' property equals 'powerFactor'."},"realPower":{"type":"object","properties":{"draw":{"type":"number","format":"float","description":"Real power reading in watts."}},"description":"Reading for the 'realPower' metric. This will only be present if the 'metric' property equals 'realPower'."},"temperature":{"type":"object","properties":{"fahrenheit":{"type":"number","format":"float","description":"Temperature reading in degrees Fahrenheit."},"celsius":{"type":"number","format":"float","description":"Temperature reading in degrees Celsius."}},"description":"Reading for the 'temperature' metric. This will only be present if the 'metric' property equals 'temperature'."},"tvoc":{"type":"object","properties":{"concentration":{"type":"integer","description":"TVOC reading in micrograms per cubic meter."}},"description":"Reading for the 'tvoc' metric. This will only be present if the 'metric' property equals 'tvoc'."},"upstreamPower":{"type":"object","properties":{"outageDetected":{"type":"boolean","description":"True if an upstream power outage was detected."}},"description":"Reading for the 'upstreamPower' metric. This will only be present if the 'metric' property equals 'upstreamPower'."},"voltage":{"type":"object","properties":{"level":{"type":"number","format":"float","description":"Voltage reading in volts."}},"description":"Reading for the 'voltage' metric. This will only be present if the 'metric' property equals 'voltage'."},"water":{"type":"object","properties":{"present":{"type":"boolean","description":"True if water is detected."}},"description":"Reading for the 'water' metric. This will only be present if the 'metric' property equals 'water'."}},"description":"The sensor reading that triggered the alert."},"profile":{"type":"object","properties":{"id":{"type":"string","description":"ID of the sensor alert profile."},"name":{"type":"string","description":"Name of the sensor alert profile."},"condition":{"type":"object","properties":{"metric":{"type":"string","enum":["apparentPower","co2","current","door","frequency","humidity","indoorAirQuality","noise","pm25","powerFactor","realPower","temperature","tvoc","upstreamPower","voltage","water"],"description":"The type of sensor metric that will be monitored for changes."},"threshold":{"type":"object","properties":{"temperature":{"type":"object","properties":{"celsius":{"type":"number","format":"float","description":"Alerting threshold in degrees Celsius."},"fahrenheit":{"type":"number","format":"float","description":"Alerting threshold in degrees Fahrenheit."},"quality":{"type":"string","enum":["fair","good","inadequate","poor"],"description":"Alerting threshold as a qualitative temperature level."}},"description":"Temperature threshold. One of 'celsius', 'fahrenheit', or 'quality' must be provided."},"humidity":{"type":"object","properties":{"relativePercentage":{"type":"integer","description":"Alerting threshold in %RH."},"quality":{"type":"string","enum":["fair","good","inadequate","poor"],"description":"Alerting threshold as a qualitative humidity level."}},"description":"Humidity threshold. One of 'relativePercentage' or 'quality' must be provided."},"water":{"type":"object","properties":{"present":{"type":"boolean","description":"Alerting threshold for a water detection event. Must be set to true."}},"required":["present"],"description":"Water detection threshold. 'present' must be provided and set to true."},"door":{"type":"object","properties":{"open":{"type":"boolean","description":"Alerting threshold for a door open event. Must be set to true."}},"required":["open"],"description":"Door open threshold. 'open' must be provided and set to true."},"tvoc":{"type":"object","properties":{"concentration":{"type":"integer","description":"Alerting threshold as TVOC micrograms per cubic meter."},"quality":{"type":"string","enum":["fair","good","inadequate","poor"],"description":"Alerting threshold as a qualitative TVOC level."}},"description":"TVOC concentration threshold. One of 'concentration' or 'quality' must be provided."},"co2":{"type":"object","properties":{"concentration":{"type":"integer","description":"Alerting threshold as CO2 parts per million."},"quality":{"type":"string","enum":["fair","good","inadequate","poor"],"description":"Alerting threshold as a qualitative CO2 level."}},"description":"CO2 concentration threshold. One of 'concentration' or 'quality' must be provided."},"pm25":{"type":"object","properties":{"concentration":{"type":"integer","description":"Alerting threshold as PM2.5 parts per million."},"quality":{"type":"string","enum":["fair","good","inadequate","poor"],"description":"Alerting threshold as a qualitative PM2.5 level."}},"description":"PM2.5 concentration threshold. One of 'concentration' or 'quality' must be provided."},"noise":{"type":"object","properties":{"ambient":{"type":"object","properties":{"level":{"type":"integer","description":"Alerting threshold as adjusted decibels."},"quality":{"type":"string","enum":["fair","good","inadequate","poor"],"description":"Alerting threshold as a qualitative ambient noise level."}},"description":"Ambient noise threshold. One of 'level' or 'quality' must be provided."}},"required":["ambient"],"description":"Noise threshold. 'ambient' must be provided."},"indoorAirQuality":{"type":"object","properties":{"score":{"type":"integer","description":"Alerting threshold as indoor air quality score."},"quality":{"type":"string","enum":["fair","good","inadequate","poor"],"description":"Alerting threshold as a qualitative indoor air quality level."}},"description":"Indoor air quality score threshold. One of 'score' or 'quality' must be provided."},"realPower":{"type":"object","properties":{"draw":{"type":"number","format":"float","description":"Alerting threshold in watts. Must be between 0 and 3750."}},"required":["draw"],"description":"Real power threshold. 'draw' must be provided."},"apparentPower":{"type":"object","properties":{"draw":{"type":"number","format":"float","description":"Alerting threshold in volt-amps. Must be between 0 and 3750."}},"required":["draw"],"description":"Apparent power threshold. 'draw' must be provided."},"powerFactor":{"type":"object","properties":{"percentage":{"type":"integer","description":"Alerting threshold as the ratio of active power to apparent power. Must be between 0 and 100."}},"required":["percentage"],"description":"Power factor threshold. 'percentage' must be provided."},"current":{"type":"object","properties":{"draw":{"type":"number","format":"float","description":"Alerting threshold in amps. Must be between 0 and 15."}},"required":["draw"],"description":"Electrical current threshold. 'level' must be provided."},"voltage":{"type":"object","properties":{"level":{"type":"number","format":"float","description":"Alerting threshold in volts. Must be between 0 and 250."}},"required":["level"],"description":"Voltage threshold. 'level' must be provided."},"frequency":{"type":"object","properties":{"level":{"type":"number","format":"float","description":"Alerting threshold in hertz. Must be between 0 and 60."}},"required":["level"],"description":"Electrical frequency threshold. 'level' must be provided."},"upstreamPower":{"type":"object","properties":{"outageDetected":{"type":"boolean","description":"Alerting threshold for an upstream power event. Must be set to true."}},"required":["outageDetected"],"description":"Upstream power threshold. 'outageDetected' must be provided and set to true."}},"description":"Threshold for sensor readings that will cause an alert to be sent. This object should contain a single property key matching the condition's 'metric' value."},"direction":{"type":"string","enum":["above","below"],"description":"If 'above', an alert will be sent when a sensor reads above the threshold. If 'below', an alert will be sent when a sensor reads below the threshold. Only applicable for temperature, humidity, realPower, apparentPower, powerFactor, voltage, current, and frequency thresholds."},"duration":{"type":"integer","enum":[0,60,120,180,240,300,600,900,1800,3600,7200,14400,28800],"description":"Length of time in seconds that the triggering state must persist before an alert is sent. Available options are 0 seconds, 1 minute, 2 minutes, 3 minutes, 4 minutes, 5 minutes, 10 minutes, 15 minutes, 30 minutes, 1 hour, 2 hours, 4 hours, and 8 hours. Default is 0.","default":0}},"required":["metric","threshold"],"description":"Triggered alert condition for the sensor alert."}},"required":["id","name","condition"],"description":"The triggered sensor alert profile"},"snapshotCamera":{"type":"object","properties":{"serial":{"type":"string","description":"Serial number of the camera"},"name":{"type":"string","description":"Name of the camera"},"url":{"type":"string","description":"URL to the camera"}},"required":["serial","name","url"],"description":"Camera snapshot information for the alert. If the sensor did not have a camera assigned at the time of the alert, this will be null."}},"required":["startTs","sensor","trigger","profile"]}},"example":[{"startTs":"2018-02-11T00:00:00.090210Z","sensor":{"name":"My sensor","serial":"Q234-ABCD-5678","model":"MT10","url":"http://example.com"},"trigger":{"ts":"2021-10-18T23:54:48.000000Z","metric":"temperature","apparentPower":{"draw":15.9},"co2":{"concentration":100},"current":{"draw":0.13},"door":{"open":true},"frequency":{"level":60.1},"humidity":{"relativePercentage":34},"indoorAirQuality":{"score":89},"noise":{"ambient":{"level":45}},"pm25":{"concentration":100},"powerFactor":{"percentage":86},"realPower":{"draw":13.7},"temperature":{"fahrenheit":77.81,"celsius":25.45},"tvoc":{"concentration":100},"upstreamPower":{"outageDetected":true},"voltage":{"level":122.4},"water":{"present":true}},"profile":{"id":"1","name":"Too hot","condition":{"metric":"temperature","threshold":{"temperature":{"celsius":20.5,"fahrenheit":70,"quality":"good"},"humidity":{"relativePercentage":65,"quality":"inadequate"},"water":{"present":true},"door":{"open":true},"tvoc":{"concentration":400,"quality":"poor"},"co2":{"concentration":400,"quality":"poor"},"pm25":{"concentration":90,"quality":"fair"},"noise":{"ambient":{"level":120,"quality":"poor"}},"indoorAirQuality":{"score":80,"quality":"fair"},"realPower":{"draw":14.1},"apparentPower":{"draw":17.2},"powerFactor":{"percentage":81},"current":{"draw":0.14},"voltage":{"level":119.5},"frequency":{"level":58.8},"upstreamPower":{"outageDetected":true}},"direction":"above","duration":60}},"snapshotCamera":{"serial":"QAAA-AAAA-AAAA","name":"Camera","url":"http://example.com"}}]}},"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 list of sensor alert events","tags":["sensor","monitor","alerts"],"x-release-stage":"beta","__originalOperationId":"getOrganizationSensorAlerts","security":[{"meraki_api_key":[]},{"bearerAuth":[]}],"method":"get","path":"/organizations/{organizationId}/sensor/alerts"}}