{"type":"api","title":"Get Application","meta":{"id":"/apps/pubhub/media/Meraki-Dashboard-API-v1-Documentation/426c8f7edc2cc0036fbe8fd4ce0d3ec2eda7fa14/de857a95-32cb-3f3c-8d64-0bf8514993f9","info":{"title":"Meraki Integrated API for Secure Connect","description":"The Cisco Meraki Integrated API for Secure Connect is a modern REST API based on the OpenAPI specification.\n ---\n\n [API Documentation](https://meraki.io/api)\n\n [Meraki Homepage](https://www.meraki.com)\n","version":"1.8.0","contact":{"name":"Meraki Developer Community","url":"https://meraki.io/community"}},"security":[{"meraki_api_key":[]},{"bearerAuth":[]}],"tags":[{"name":"Reports"},{"name":"Activity"},{"name":"Top Categories"},{"name":"Organization Requests by Timerange and Category"},{"name":"Total Requests"},{"name":"Summary"},{"name":"Applications"},{"name":"Deployments"},{"name":"Data Center"},{"name":"Network Devices"},{"name":"Organization Tunnel"},{"name":"Policy"},{"name":"Firewall Applications"},{"name":"Policies"},{"name":"Destination Lists"},{"name":"Destinations"}],"x-parser-conf":{"theme":"meraki","expand":2,"exampleAsDefault":true,"groupBy":{"$remoteModule":"config/group_api_tag.js"}},"openapi":"3.0.0","servers":[{"url":"https://api.meraki.com/{basePath}","variables":{"basePath":{"default":"api/secureConnect/v1"}}}],"securitySchemes":{"meraki_api_key":{"type":"apiKey","name":"X-Cisco-Meraki-API-Key","in":"header"},"bearerAuth":{"type":"apiKey","name":"Authorization","in":"header"}}},"spec":{"tags":["Reports","Applications"],"summary":"Get Application","description":"Get an application by ID.","operationId":"getApplication","parameters":[{"name":"organizationId","in":"path","description":"Organization ID associated with this resource.","required":true,"schema":{"type":"integer"}},{"in":"path","name":"applicationId","description":"The ID of the application.","required":true,"schema":{"type":"string"}}],"security":[{"meraki_api_key":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","description":"The properties of the app.","required":["id","name","description","label","weightedRisk","category","appType","url","vendor","identitiesCount","sources","firstDetected","lastDetected"],"properties":{"id":{"type":"string","description":"The ID of the app.","example":"eaqYExba"},"name":{"type":"string","description":"The name of the app.","example":"Umbrella"},"description":{"type":"string","description":"The description of the app.","example":"Offers threat intelligence solutions."},"label":{"type":"string","description":"The application label. Valid values are: `unreviewed`, `approved`, `notApproved`, `underAudit`.","enum":["unreviewed","approved","notApproved","underAudit"],"example":"approved"},"weightedRisk":{"type":"string","description":"The risk the app poses to the environment.","enum":["veryLow","low","medium","high","veryHigh"],"example":"low"},"category":{"type":"string","description":"The category applied to the app.","example":"Security"},"appType":{"type":"string","description":"The type of the app.","enum":["saas","paas","iaas"],"example":"saas"},"url":{"type":"string","description":"The URL of the app.","example":"https://umbrella.cisco.com/products/umbrella-investigate"},"vendor":{"type":"string","description":"The vendor that owns the app.","example":"Cisco"},"identitiesCount":{"type":"integer","description":"The number of identities.","example":5},"sources":{"type":"array","description":"The list of app sources where the sources are DNS, Web (Secure Web Gateway), and cloud-delivered firewall (CDFW) traffic events.\nThe list can contain one or more of the source types.","items":{"anyOf":[{"type":"object","description":"The properties of the app's DNS requests.","properties":{"name":{"type":"string","description":"The type of traffic associated with the source.","enum":["dns"],"example":"dns"},"requests":{"type":"integer","description":"The number of DNS requests for this app.","example":100},"blockedRequests":{"type":"integer","description":"The number of DNS requests blocked by Umbrella, based on policy configurations.","example":50}},"example":{"name":"dns","requests":100,"blockedRequests":35}},{"type":"object","description":"The properties of the app's web requests.","properties":{"name":{"type":"string","description":"The type of traffic associated with the source.","enum":["swg"],"example":"swg"},"totalTraffic":{"type":"integer","description":"The total number of bytes inbound and outbound for this app in your environment.","example":150},"bytesIn":{"type":"integer","description":"The number of bytes received (inbound).","example":50},"bytesOut":{"type":"integer","description":"The number of bytes sent (outbound).","example":100},"blockedBytesOut":{"type":"integer","description":"The number of bytes of outbound traffic that are blocked.","example":90}},"example":{"name":"swg","totalTraffic":200,"bytesIn":100,"bytesOut":100,"blockedBytesOut":49}},{"type":"object","description":"The properties of the app's requests that are managed by the Umbrella cloud-delivered firewall (CDFW).","properties":{"name":{"type":"string","description":"The type of traffic associated with the source.","enum":["cdfw"],"example":"cdfw"},"events":{"type":"integer","description":"The number of CDFW L7 events for this app.","example":100},"blockedEvents":{"type":"integer","description":"The number of CDFW L7 events that are blocked.","example":50}},"example":{"name":"cdfw","events":50,"blockedEvents":25}}]},"example":[{"name":"cdfw","events":50,"blockedEvents":25}]},"firstDetected":{"type":"string","format":"date-time","description":"The date when the app was first detected.","example":"2022-01-01T00:00:00.000Z"},"lastDetected":{"type":"string","description":"The date when the app was last detected.","format":"date-time","example":"2022-01-01T00:00:00.000Z"}},"example":{"id":"eaqYExba","name":"Umbrella","description":"The properties of the app.","label":"unreviewed","weightedRisk":"low","category":"Security","appType":"saas","url":"https://umbrella.cisco.com/products/umbrella-investigate","vendor":"Cisco Systems","identitiesCount":25,"sources":[{"name":"dns","requests":100,"blockedRequests":100}],"firstDetected":"2022-01-01T00:00:00.000Z","lastDetected":"2022-01-01T00:00:00.000Z"}},"example":{"id":"eaqYExba","name":"Umbrella","description":"Offers threat intelligence solutions.","label":"approved","weightedRisk":"low","category":"Security","appType":"saas","url":"https://umbrella.cisco.com/products/umbrella-investigate","vendor":"Cisco","identitiesCount":5,"sources":[{"name":"cdfw","events":50,"blockedEvents":25},{"name":"dns","events":35,"blockedRequests":14},{"name":"swg","totalTraffic":150,"bytesIn":50,"bytesOut":100,"blockedBytesOut":15}],"firstDetected":"2022-01-01T00:00:00.000Z","lastDetected":"2022-01-01T00:00:00.000Z"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"description":"Validation Error","type":"object","properties":{"statusCode":{"type":"integer","example":400,"description":"HTTP status code"},"error":{"type":"string","example":"Validation Error","description":"A brief description of the error"},"message":{"type":"string","description":"Detailed error message"},"validationErrors":{"type":"object","properties":{"someProperty":{"type":"string","example":"must not be empty","description":"the name of the property failing validation."}}}}}}}},"401":{"description":"Unauthorized request","content":{"application/json":{"schema":{"description":"Unauthorized- The authorization header is missing or the token is unauthorized","type":"object","properties":{"statusCode":{"type":"integer","example":401,"description":"HTTP status code"},"error":{"type":"string","example":"Unauthorized","description":"A brief description of the error"},"message":{"type":"string","description":"Detailed error message"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"description":"Forbidden- The token is invalid","type":"object","properties":{"statusCode":{"type":"integer","example":403,"description":"HTTP status code"},"error":{"type":"string","example":"Forbidden, Invalid authentication credentials","description":"A brief description of the error"},"message":{"type":"string","description":"Detailed error message"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"description":"Not Found- A resource specified in the URL was not found","type":"object","properties":{"statusCode":{"type":"integer","example":404,"description":"HTTP status code"},"error":{"type":"string","example":"Not Found","description":"A brief description of the error"},"message":{"type":"string","description":"Detailed error message"}}}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}}}}}}},"__originalOperationId":"getApplication","method":"get","path":"/organizations/{organizationId}/reports/appDiscovery/applications/{applicationId}"}}